> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.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](/pt-BR/reference/system/xgameactivation/enums/xgameactivationtype)

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](/pt-BR/reference/system/xgameactivation/functions/xgameactivationcallback) 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](/pt-BR/reference/system/xgameactivation/functions/xgameactivationacceptpendinginvite) 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](/pt-BR/services/xbox-services/multiplayer/invites/how-to/live-invites-receive)

## Confira também

[XGameActivation](/pt-BR/reference/system/xgameactivation/xgameactivation_members)\
[XGameActivationType](/pt-BR/reference/system/xgameactivation/enums/xgameactivationtype)\
[XGameActivationCallback](/pt-BR/reference/system/xgameactivation/functions/xgameactivationcallback)\
[XGameActivationAcceptPendingInvite](/pt-BR/reference/system/xgameactivation/functions/xgameactivationacceptpendinginvite)


## Related topics

- [XGameActivationInfo](/reference/system/xgameactivation/structs/xgameactivationinfo.md)
- [XGameActivationType](/reference/system/xgameactivation/enums/xgameactivationtype.md)
- [XGameActivationCallback](/reference/system/xgameactivation/functions/xgameactivationcallback.md)