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

指定所發生的啟用類型。

## 語法

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

## 常數

| 常數 | 描述 |
| - | - |
| Protocol | 遊戲是透過自訂通訊協定 URI 啟用的。[XGameActivationInfo](/zh-TW/reference/system/xgameactivation/structs/xgameactivationinfo) 的 `protocolUri` 欄位包含啟用 URI。如需詳細資訊，請參閱[通訊協定啟用](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/overviews/protocolactivation)。 |
| File | 遊戲是透過檔案關聯啟用的。[XGameActivationInfo](/zh-TW/reference/system/xgameactivation/structs/xgameactivationinfo) 的 `file` 欄位包含檔案路徑。如需詳細資訊，請參閱[檔案類型啟用](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/overviews/filetypeactivation)。 |
| PendingGameInvite | 遊戲收到尚未接受的遊戲邀請。[XGameActivationInfo](/zh-TW/reference/system/xgameactivation/structs/xgameactivationinfo) 的 `inviteUri` 欄位包含邀請 URI。遊戲應向使用者顯示接受或拒絕邀請的 UI，並在使用者接受時呼叫 [XGameActivationAcceptPendingInvite](/zh-TW/reference/system/xgameactivation/functions/xgameactivationacceptpendinginvite)。 |
| AcceptedGameInvite | 遊戲因使用者接受遊戲邀請而啟用。[XGameActivationInfo](/zh-TW/reference/system/xgameactivation/structs/xgameactivationinfo) 的 `inviteUri` 欄位包含邀請 URI。 |

## 備註

[XGameActivationInfo](/zh-TW/reference/system/xgameactivation/structs/xgameactivationinfo) 結構會使用 **XGameActivationType** 來指出觸發 [XGameActivationCallback](/zh-TW/reference/system/xgameactivation/functions/xgameactivationcallback) 的啟用種類。啟用類型決定 `XGameActivationInfo` 聯集的哪個欄位包含有效資料。

此列舉設計為可擴充。未來的 GDK 版本可能會新增其他啟用類型。遊戲應以忽略的方式妥善處理未知的值。

## 需求

**標頭：** XGameActivation.h

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

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


## Related topics

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