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

包含傳遞給啟用回呼的啟用資訊。

## 語法

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

### 成員

*type*\
類型：[XGameActivationType](/zh-TW/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` 時有效。

## 備註

發生啟用事件時，**XGameActivationInfo** 結構會傳遞給 [XGameActivationCallback](/zh-TW/reference/system/xgameactivation/functions/xgameactivationcallback)。`type` 欄位指出啟用的種類，對應的聯集欄位則包含相關資料。

當啟用類型為 `PendingGameInvite` 時，遊戲應顯示 UI，讓使用者接受或拒絕邀請。如果使用者接受，請使用 `inviteUri` 呼叫 [XGameActivationAcceptPendingInvite](/zh-TW/reference/system/xgameactivation/functions/xgameactivationacceptpendinginvite)。這會觸發後續類型為 `AcceptedGameInvite` 的回呼。

## 需求

**標頭：** XGameActivation.h

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

## 概念文件

* [檔案類型啟用](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/overviews/filetypeactivation)
* [接收邀請](/zh-TW/services/xbox-services/multiplayer/invites/how-to/live-invites-receive)

## 另請參閱

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


## Related topics

- [XGameActivationCallback](/zh-TW/reference/system/xgameactivation/functions/xgameactivationcallback.md)
- [XGameActivationType](/zh-TW/reference/system/xgameactivation/enums/xgameactivationtype.md)
- [XGameActivation](/zh-TW/reference/system/xgameactivation/xgameactivation_members.md)
- [XGameActivationAcceptPendingInvite](/zh-TW/reference/system/xgameactivation/functions/xgameactivationacceptpendinginvite.md)
- [接收邀請](/zh-TW/services/xbox-services/multiplayer/invites/how-to/live-invites-receive.md)