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

# XGameActivationType

> XGameActivationType

# XGameActivationType

指定发生的激活类型。

## Syntax

```cpp theme={null}
enum class XGameActivationType : uint32_t  
{  
    Protocol = 0,  
    File = 1,  
    PendingGameInvite = 2,  
    AcceptedGameInvite = 3  
}  
```

## Constants

| Constant           | Description                                                                                                                                                                                                                                                                        |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Protocol           | 游戏通过自定义协议 URI 激活。[XGameActivationInfo](/reference/system/xgameactivation/structs/xgameactivationinfo) 的 `protocolUri` 字段包含激活 URI。有关详细信息，请参阅[协议激活](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/overviews/protocolactivation)。                                               |
| File               | 游戏通过文件关联激活。[XGameActivationInfo](/reference/system/xgameactivation/structs/xgameactivationinfo) 的 `file` 字段包含文件路径。有关详细信息，请参阅[文件类型激活](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/overviews/filetypeactivation)。                                                            |
| PendingGameInvite  | 游戏收到了尚未接受的游戏邀请。[XGameActivationInfo](/reference/system/xgameactivation/structs/xgameactivationinfo) 的 `inviteUri` 字段包含邀请 URI。游戏应向用户呈现 UI 以接受或拒绝邀请，如果用户接受，则调用 [XGameActivationAcceptPendingInvite](/reference/system/xgameactivation/functions/xgameactivationacceptpendinginvite)。 |
| AcceptedGameInvite | 因用户接受游戏邀请而激活游戏。[XGameActivationInfo](/reference/system/xgameactivation/structs/xgameactivationinfo) 的 `inviteUri` 字段包含邀请 URI。                                                                                                                                                      |

## Remarks

**XGameActivationType** 由 [XGameActivationInfo](/reference/system/xgameactivation/structs/xgameactivationinfo) 结构使用，用于指示触发 [XGameActivationCallback](/reference/system/xgameactivation/functions/xgameactivationcallback) 的激活类型。激活类型决定了 `XGameActivationInfo` 联合的哪个字段包含有效数据。

此枚举设计为可扩展的。将来的 GDK 版本可能会添加其他激活类型。游戏应通过忽略未知值来正常处理它们。

## Requirements

**头文件：** XGameActivation.h

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

## See also

[XGameActivation](/reference/system/xgameactivation/xgameactivation_members)\
[XGameActivationInfo](/reference/system/xgameactivation/structs/xgameactivationinfo)\
[XGameActivationCallback](/reference/system/xgameactivation/functions/xgameactivationcallback)


## Related topics

- [XGameActivationInfo](/zh-CN/reference/system/xgameactivation/structs/xgameactivationinfo.md)
- [XGameActivation](/zh-CN/reference/system/xgameactivation/xgameactivation_members.md)
- [XGameActivationCallback](/zh-CN/reference/system/xgameactivation/functions/xgameactivationcallback.md)
- [XGameActivationAcceptPendingInvite](/zh-CN/reference/system/xgameactivation/functions/xgameactivationacceptpendinginvite.md)
- [XGameActivationRegisterForEvent](/zh-CN/reference/system/xgameactivation/functions/xgameactivationregisterforevent.md)