> ## 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

包含传递给激活回调的激活信息。

## Syntax

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

### Members

*type*\
类型：[XGameActivationType](/reference/system/xgameactivation/enums/xgameactivationtype)

发生的激活类型。决定联合的哪个字段包含有效数据。

*protocolUri*\
类型：const char\*

激活游戏的协议 URI。当 `type` 为 `XGameActivationType::Protocol` 时有效。

*file*\
类型：const char\*

激活游戏的文件路径。当 `type` 为 `XGameActivationType::File` 时有效。

*inviteUri*\
类型：const char\*

游戏会话的邀请 URI。当 `type` 为 `XGameActivationType::PendingGameInvite` 或 `XGameActivationType::AcceptedGameInvite` 时有效。

## Remarks

当激活事件发生时，**XGameActivationInfo** 结构会传递到 [XGameActivationCallback](/reference/system/xgameactivation/functions/xgameactivationcallback)。`type` 字段指示激活类型，相应的联合字段包含相关数据。

当激活类型为 `PendingGameInvite` 时，游戏应呈现 UI 以允许用户接受或拒绝邀请。如果用户接受，请使用 `inviteUri` 调用 [XGameActivationAcceptPendingInvite](/reference/system/xgameactivation/functions/xgameactivationacceptpendinginvite)。这将触发具有 `AcceptedGameInvite` 类型的后续回调。

## Requirements

**头文件：** XGameActivation.h

**受支持的平台：** Windows、XBOX One 系列主机和 XBOX Series 主机

## Conceptual documentation

* [文件类型激活](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/overviews/filetypeactivation)
* [接收邀请](/services/xbox-services/multiplayer/invites/how-to/live-invites-receive)

## See also

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


## Related topics

- [XGameActivationCallback](/zh-CN/reference/system/xgameactivation/functions/xgameactivationcallback.md)
- [XGameActivationType](/zh-CN/reference/system/xgameactivation/enums/xgameactivationtype.md)
- [XGameActivation](/zh-CN/reference/system/xgameactivation/xgameactivation_members.md)
- [XGameActivationAcceptPendingInvite](/zh-CN/reference/system/xgameactivation/functions/xgameactivationacceptpendinginvite.md)
- [XGameActivationRegisterForEvent](/zh-CN/reference/system/xgameactivation/functions/xgameactivationregisterforevent.md)