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

# XGameActivationRegisterForEvent

> XGameActivationRegisterForEvent

# XGameActivationRegisterForEvent

註冊啟用事件的回呼。

## 語法

```cpp theme={null}
HRESULT XGameActivationRegisterForEvent(  
         XTaskQueueHandle queue,  
         void* context,  
         XGameActivationCallback* callback,  
         XTaskQueueRegistrationToken* token  
)  
```

### 參數

*queue*   \_In\_opt\_\
類型：XTaskQueueHandle

分派事件回呼的工作佇列。

*context*   \_In\_opt\_\
類型：void\*

傳遞給事件回呼的內容。

*callback*   \_In\_\
類型：[XGameActivationCallback](/zh-TW/reference/system/xgameactivation/functions/xgameactivationcallback)\*

事件回呼函式。

*token*   \_Out\_\
類型：[XTaskQueueRegistrationToken\*](/zh-TW/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken)

來自工作佇列、代表此註冊的權杖。使用此權杖可取消註冊啟用事件的回呼。

### 傳回值

類型：HRESULT

HRESULT 成功或錯誤碼。\
如需錯誤碼清單，請參閱[錯誤碼](/zh-TW/reference/errorcodes)。

## 備註

<Note>在時間敏感的執行緒上呼叫此函式並不安全。如需詳細資訊，請參閱[時間敏感的執行緒](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)。</Note>

**XGameActivationRegisterForEvent** 函式會使用 [XGameActivationCallback](/zh-TW/reference/system/xgameactivation/functions/xgameactivationcallback) 作為引數。回呼會收到包含啟用類型和對應資料的 [XGameActivationInfo](/zh-TW/reference/system/xgameactivation/structs/xgameactivationinfo) 結構。

此 API 會處理所有啟用類型，包括通訊協定啟用、檔案啟用和遊戲邀請。它取代了已淘汰的 `XGameProtocolRegisterForActivation` 和 `XGameInviteRegisterForEvent` API。

若要取消註冊啟用事件的回呼，請呼叫 [XGameActivationUnregisterForEvent](/zh-TW/reference/system/xgameactivation/functions/xgameactivationunregisterforevent)。

如需呼叫此函式的範例，請參閱 [XGameActivationCallback](/zh-TW/reference/system/xgameactivation/functions/xgameactivationcallback#remarks) 主題的備註一節。

## 需求

**標頭：** XGameActivation.h

**程式庫：** xgameruntime.lib

**支援的平台：** 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)

[XGameActivationCallback](/zh-TW/reference/system/xgameactivation/functions/xgameactivationcallback)

[XGameActivationUnregisterForEvent](/zh-TW/reference/system/xgameactivation/functions/xgameactivationunregisterforevent)


## Related topics

- [XGameActivationRegisterForEvent](/reference/system/xgameactivation/functions/xgameactivationregisterforevent.md)
- [XGameActivation](/reference/system/xgameactivation/xgameactivation_members.md)