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

アクティブ化イベントのコールバックを登録します。

## Syntax

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

### Parameters

*queue*   \_In\_opt\_\
型: XTaskQueueHandle

イベント コールバックをディスパッチするタスク キュー。

*context*   \_In\_opt\_\
型: void\*

イベント コールバックに渡されるコンテキスト。

*callback*   \_In\_\
型: [XGameActivationCallback](/reference/system/xgameactivation/functions/xgameactivationcallback)\*

イベント コールバック関数。

*token*   \_Out\_\
型: [XTaskQueueRegistrationToken\*](/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken)

登録を表すタスク キューからのトークン。このトークンを使用して、アクティブ化イベントのコールバックの登録を解除します。

### Return value

型: HRESULT

HRESULT の成功またはエラー コード。\
エラー コードの一覧については、[エラー コード](/reference/errorcodes)を参照してください。

## Remarks

<Note>この関数は、時間依存スレッドから呼び出しても安全ではありません。詳細については、[Time-sensitive threads](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads) を参照してください。</Note>

**XGameActivationRegisterForEvent** 関数は、[XGameActivationCallback](/reference/system/xgameactivation/functions/xgameactivationcallback) を引数として使用します。コールバックは、アクティブ化の種類と対応するデータを含む [XGameActivationInfo](/reference/system/xgameactivation/structs/xgameactivationinfo) 構造体を受け取ります。

この API は、プロトコル アクティブ化、ファイル アクティブ化、およびゲーム招待を含むすべてのアクティブ化タイプを処理します。非推奨の `XGameProtocolRegisterForActivation` および `XGameInviteRegisterForEvent` API を置き換えます。

アクティブ化イベントのコールバックの登録を解除するには、[XGameActivationUnregisterForEvent](/reference/system/xgameactivation/functions/xgameactivationunregisterforevent) を呼び出します。

この関数の呼び出し例については、[XGameActivationCallback](/reference/system/xgameactivation/functions/xgameactivationcallback#remarks) トピックの「Remarks」セクションを参照してください。

## Requirements

**ヘッダー:** XGameActivation.h

**ライブラリ:** xgameruntime.lib

**サポートされているプラットフォーム:** Windows、XBOX One ファミリー本体および XBOX Series 本体

## Conceptual documentation

* [File type activation](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/overviews/filetypeactivation)
* [Receiving invites](/services/xbox-services/multiplayer/invites/how-to/live-invites-receive)

## See also

[XGameActivation](/reference/system/xgameactivation/xgameactivation_members)

[XGameActivationCallback](/reference/system/xgameactivation/functions/xgameactivationcallback)

[XGameActivationUnregisterForEvent](/reference/system/xgameactivation/functions/xgameactivationunregisterforevent)


## Related topics

- [XGameActivation](/ja-jp/reference/system/xgameactivation/xgameactivation_members.md)
- [XGameActivationUnregisterForEvent](/ja-jp/reference/system/xgameactivation/functions/xgameactivationunregisterforevent.md)
- [XGameActivationCallback](/ja-jp/reference/system/xgameactivation/functions/xgameactivationcallback.md)
- [XGameProtocolRegisterForActivation (deprecated)](/ja-jp/reference/system/xgameprotocol/functions/xgameprotocolregisterforactivation.md)
- [XGameInviteRegisterForEvent (deprecated)](/ja-jp/reference/system/xgameinvite/functions/xgameinviteregisterforevent.md)