> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XGameActivationInfo

> XGameActivationInfo

# XGameActivationInfo

Contém as informações de ativação passadas para o retorno de chamada de ativação.

## Sintaxe

```cpp theme={null}
struct XGameActivationInfo  
{  
    XGameActivationType type;  
    union  
    {  
        const char* protocolUri;  
        const char* file;  
        const char* inviteUri;  
    };  
};  
```

### Membros

*type*\
Tipo: [XGameActivationType](https://docs.xbox.com/pt-BR/reference/system/xgameactivation/enums/xgameactivationtype.md)

O tipo de ativação que ocorreu. Determina qual campo da união contém dados válidos.

*protocolUri*\
Tipo: const char\*

O URI de protocolo que ativou o jogo. Válido quando `type` é `XGameActivationType::Protocol`.

*file*\
Tipo: const char\*

O caminho do arquivo que ativou o jogo. Válido quando `type` é `XGameActivationType::File`.

*inviteUri*\
Tipo: const char\*

O URI do convite para a sessão de jogo. Válido quando `type` é `XGameActivationType::PendingGameInvite` ou `XGameActivationType::AcceptedGameInvite`.

## Comentários

A estrutura **XGameActivationInfo** é passada para o [XGameActivationCallback](https://docs.xbox.com/pt-BR/reference/system/xgameactivation/functions/xgameactivationcallback.md) quando ocorre um evento de ativação. O campo `type` indica o tipo de ativação, e o campo de união correspondente contém os dados relevantes.

Quando o tipo de ativação é `PendingGameInvite`, o jogo deve apresentar uma interface do usuário para permitir que o usuário aceite ou rejeite o convite. Se o usuário aceitar, chame [XGameActivationAcceptPendingInvite](https://docs.xbox.com/pt-BR/reference/system/xgameactivation/functions/xgameactivationacceptpendinginvite.md) com o `inviteUri`. Isso dispara um retorno de chamada subsequente com o tipo `AcceptedGameInvite`.

## Requisitos

**Cabeçalho:** XGameActivation.h

**Plataformas compatíveis:** Windows, consoles da família XBOX One e consoles XBOX Series

## Documentação conceitual

* [Ativação de tipo de arquivo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/overviews/filetypeactivation)
* [Recebendo convites](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/invites/how-to/live-invites-receive.md)

## Confira também

[XGameActivation](https://docs.xbox.com/pt-BR/reference/system/xgameactivation/xgameactivation_members.md)\
[XGameActivationType](https://docs.xbox.com/pt-BR/reference/system/xgameactivation/enums/xgameactivationtype.md)\
[XGameActivationCallback](https://docs.xbox.com/pt-BR/reference/system/xgameactivation/functions/xgameactivationcallback.md)\
[XGameActivationAcceptPendingInvite](https://docs.xbox.com/pt-BR/reference/system/xgameactivation/functions/xgameactivationacceptpendinginvite.md)


## Related topics

- [XGameActivationCallback](https://docs.xbox.com/pt-BR/reference/system/xgameactivation/functions/xgameactivationcallback.md)
- [XGameActivationType](https://docs.xbox.com/pt-BR/reference/system/xgameactivation/enums/xgameactivationtype.md)
- [XGameActivation (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/system/xgameactivation/xgameactivation_members.md)
- [XGameActivationAcceptPendingInvite](https://docs.xbox.com/pt-BR/reference/system/xgameactivation/functions/xgameactivationacceptpendinginvite.md)
- [XGameActivationRegisterForEvent](https://docs.xbox.com/pt-BR/reference/system/xgameactivation/functions/xgameactivationregisterforevent.md)