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

# XGameInviteEventCallback (已淘汰)

> XGameInviteEventCallback (已淘汰)

# XGameInviteEventCallback (已淘汰)

<Info>此 API 現已淘汰。請改用 [XGameActivationCallback](/zh-TW/reference/system/xgameactivation/functions/xgameactivationcallback)。</Info>

應用程式為遊戲邀請事件定義的回呼。

## 語法

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

### 參數

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

我們傳遞給 [XGameInviteRegisterForEvent](/zh-TW/reference/system/xgameinvite/functions/xgameinviteregisterforevent) 的內容。

*inviteUri*   \_In\_\
類型：char\*

用於加入遊戲工作階段的 URI。\
<Note>XSAPI 知道如何使用此 URI。</Note>

### 傳回值

類型：void

<a id="ID_XGameInviteEventCallback_Remarks" />

## 備註

若要註冊遊戲邀請事件的回呼，請呼叫 [XGameInviteRegisterForEvent](/zh-TW/reference/system/xgameinvite/functions/xgameinviteregisterforevent)。此函式會使用 **XGameInviteEventCallback** 的指標作為引數。

若要取消註冊遊戲邀請事件的回呼，請呼叫 [XGameInviteUnregisterForEvent](/zh-TW/reference/system/xgameinvite/functions/xgameinviteunregisterforevent)。

下列程式碼範例會註冊遊戲邀請回呼。

```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);  
}  
```

## 需求

**標頭：** XGameInvite.h

**程式庫：** xgameruntime.lib

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

## 另請參閱

[XGameInvite](/zh-TW/reference/system/xgameinvite/xgameinvite_members)

[XGameInviteRegisterForEvent](/zh-TW/reference/system/xgameinvite/functions/xgameinviteregisterforevent)

[XGameInviteUnregisterForEvent](/zh-TW/reference/system/xgameinvite/functions/xgameinviteunregisterforevent)


## Related topics

- [XGameInviteEventCallback (deprecated)](/zh-CN/reference/system/xgameinvite/functions/xgameinviteeventcallback.md)
- [XGameInviteEventCallback (en desuso)](/es/reference/system/xgameinvite/functions/xgameinviteeventcallback.md)
- [XGameInviteUnregisterForEvent (deprecated)](/reference/system/xgameinvite/functions/xgameinviteunregisterforevent.md)
- [XGameInviteRegisterForEvent (deprecated)](/reference/system/xgameinvite/functions/xgameinviteregisterforevent.md)
- [XGameInvite (deprecated)](/reference/system/xgameinvite/xgameinvite_members.md)