> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XGameInviteEventCallback (非推奨)

> XGameInviteEventCallback (deprecated)

# XGameInviteEventCallback (deprecated)

> [!NOTE]
>
> この API は非推奨になりました。代わりに [XGameActivationCallback](https://docs.xbox.com/ja-jp/reference/system/xgameactivation/functions/xgameactivationcallback.md) を使用してください。

アプリケーションがゲーム招待イベントに対して定義するコールバック。

## Syntax

```cpp theme={null}
void XGameInviteEventCallback(  
         void* context,  
         const char* inviteUri  
)  
```

### Parameters

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

[XGameInviteRegisterForEvent](https://docs.xbox.com/ja-jp/reference/system/xgameinvite/functions/xgameinviteregisterforevent.md) に渡すコンテキスト。

*inviteUri*   \_In\_\
型: char\*

ゲーム セッションに参加するための URI。\
\[!NOTE] XSAPI は URI の使用方法を認識しています。

### Return value

型: void

## Remarks

ゲーム招待イベントのコールバックを登録するには、[XGameInviteRegisterForEvent](https://docs.xbox.com/ja-jp/reference/system/xgameinvite/functions/xgameinviteregisterforevent.md) を呼び出します。この関数は、**XGameInviteEventCallback** へのポインターを引数として使用します。

ゲーム招待イベントのコールバックの登録を解除するには、[XGameInviteUnregisterForEvent](https://docs.xbox.com/ja-jp/reference/system/xgameinvite/functions/xgameinviteunregisterforevent.md) を呼び出します。

次のコード サンプルは、ゲーム招待コールバックに登録します。

```cpp theme={null}
#include <XTaskQueue.h>
#include <XGameInvite.h>  
  
XTaskQueueHandle g_taskQueue;  
XTaskQueueRegistrationToken g_gameInviteEventToken;  
  
void OnGameInvite(void* context, const char* inviteUri)  
{  
    if (inviteUri != nullptr)
    {
        std::string inviteString(inviteUri);
        auto pos = inviteString.find("handle=");
        auto inviteHandeId = inviteString.substr(pos + 7, 36);
        // Now call XblMultiplayerManagerJoinLobby if using MPM
        // or call XblMultiplayerWriteSessionByHandleAsync if using MPSD APIs
    }
}  
  
void InitializeGame()  
{  
    XGameInviteRegisterForEvent(g_taskQueue, nullptr, OnGameInvite, &g_gameInviteEventToken);  
}  
  
void ShutdownGame()  
{  
    XGameInviteUnregisterForEvent(g_gameInviteEventToken);  
}  
```

## Requirements

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

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

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

## See also

[XGameInvite](https://docs.xbox.com/ja-jp/reference/system/xgameinvite/xgameinvite_members.md)

[XGameInviteRegisterForEvent](https://docs.xbox.com/ja-jp/reference/system/xgameinvite/functions/xgameinviteregisterforevent.md)

[XGameInviteUnregisterForEvent](https://docs.xbox.com/ja-jp/reference/system/xgameinvite/functions/xgameinviteunregisterforevent.md)


## Related topics

- [XGameInviteUnregisterForEvent (非推奨)](https://docs.xbox.com/ja-jp/reference/system/xgameinvite/functions/xgameinviteunregisterforevent.md)
- [XGameInvite (非推奨)](https://docs.xbox.com/ja-jp/reference/system/xgameinvite/xgameinvite_members.md)
- [XGameInviteRegisterForEvent (非推奨)](https://docs.xbox.com/ja-jp/reference/system/xgameinvite/functions/xgameinviteregisterforevent.md)
- [XGameProtocolActivationCallbackXGameProtocol (非推奨)](https://docs.xbox.com/ja-jp/reference/system/xgameprotocol/functions/xgameprotocolactivationcallback.md)
- [GameInputGuidButtonCallback (非推奨)](https://docs.xbox.com/ja-jp/reference/input/gameinput/deprecated/functions/gameinputguidebuttoncallback.md)