> ## 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 (deprecated)

> XGameInviteEventCallback (deprecated)

# XGameInviteEventCallback (사용되지 않음)

<Info>이 API는 이제 사용되지 않습니다. 대신 [XGameActivationCallback](/reference/system/xgameactivation/functions/xgameactivationcallback)을 사용하세요.</Info>

게임 초대 이벤트에 대해 애플리케이션이 정의하는 콜백입니다.

## 구문

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

### 매개 변수

*context*   \_In\_opt\_\
형식: void\*

[XGameInviteRegisterForEvent](/reference/system/xgameinvite/functions/xgameinviteregisterforevent)에 전달하는 컨텍스트입니다.

*inviteUri*   \_In\_\
형식: char\*

게임 세션에 참가하기 위한 URI입니다.\
<Note>XSAPI가 URI를 사용하는 방법을 알고 있습니다.</Note>

### 반환 값

형식: void

<a id="ID_XGameInviteEventCallback_Remarks" />

## 설명

게임 초대 이벤트에 대한 콜백을 등록하려면 [XGameInviteRegisterForEvent](/reference/system/xgameinvite/functions/xgameinviteregisterforevent)를 호출합니다. 이 함수는 **XGameInviteEventCallback**에 대한 포인터를 인수로 사용합니다.

게임 초대 이벤트에 대한 콜백을 등록 해제하려면 [XGameInviteUnregisterForEvent](/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](/reference/system/xgameinvite/xgameinvite_members)

[XGameInviteRegisterForEvent](/reference/system/xgameinvite/functions/xgameinviteregisterforevent)

[XGameInviteUnregisterForEvent](/reference/system/xgameinvite/functions/xgameinviteunregisterforevent)


## Related topics

- [XGameInviteUnregisterForEvent (deprecated)](/ko/reference/system/xgameinvite/functions/xgameinviteunregisterforevent.md)
- [XGameInviteRegisterForEvent (deprecated)](/ko/reference/system/xgameinvite/functions/xgameinviteregisterforevent.md)
- [XGameInvite (deprecated)](/ko/reference/system/xgameinvite/xgameinvite_members.md)
- [XGameActivationCallback](/ko/reference/system/xgameactivation/functions/xgameactivationcallback.md)
- [XGameProtocolActivationCallbackXGameProtocol (deprecated)](/ko/reference/system/xgameprotocol/functions/xgameprotocolactivationcallback.md)