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

# XGameUiShowSendGameInviteAsync

> XGameUiShowSendGameInviteAsync

# XGameUiShowSendGameInviteAsync

이 메서드는 게임 초대를 보내기 위해 선택된 플레이어의 친구 목록 및 추천 친구 목록에서 채워진 선택기 UI를 표시합니다.

## 구문

```cpp theme={null}
HRESULT XGameUiShowSendGameInviteAsync(  
         XAsyncBlock* async,  
         XUserHandle requestingUser,  
         const char* sessionConfigurationId,  
         const char* sessionTemplateName,  
         const char* sessionId,  
         const char* invitationText,  
         const char* customActivationContext  
)  
```

### 매개 변수

*async*   \_In\_<br />형식: [XAsyncBlock\*](/reference/system/xasync/structs/xasyncblock)

[XAsyncRun](/reference/system/xasync/functions/xasyncrun)에 전달되는 [XAsyncBlock](/reference/system/xasync/structs/xasyncblock)에 대한 포인터입니다.

*requestingUser*   \_In\_<br />형식: XUserHandle

초대를 보내는 사용자에 대한 핸들입니다.

*sessionConfigurationId*   \_In\_<br />형식: char\*

타이틀의 서비스 구성 ID를 나타내는 문자열을 지정합니다.

*sessionTemplateName*   \_In\_<br />형식: char\*

멀티플레이어 세션 템플릿의 이름을 나타내는 문자열을 지정합니다.

*sessionId*   \_In\_<br />형식: char\*

초대할 멀티플레이어 세션의 ID를 나타내는 문자열을 지정합니다.

*invitationText*   \_In\_opt\_<br />형식: char\*

사용자 지정 초대 문자열 ID를 나타내는 문자열을 지정합니다.<br />이 문자열 ID는 XBOX Live 서비스 구성에 정의되어 있으며, 표준 초대 텍스트에 추가되는 초대 텍스트를 식별합니다. ID 문자열은 "///" 접두사로 시작해야 합니다. 초대에 사용자 지정 문자열을 추가하지 않으려면 빈 문자열을 전달하세요.

*customActivationContext*   \_In\_opt\_<br />형식: char\*

초대 활성화 URI에서 초대받은 사용자에게 제공되는 사용자 지정 활성화 컨텍스트입니다. 사용자 지정 활성화 컨텍스트 문자열은 URL에 안전해야 하며, 바이너리 콘텐츠는 URL에 안전한 base64 인코딩으로 인코딩되어야 합니다. 최대 길이는 160자입니다.

### 반환 값

형식: HRESULT

비동기 호출의 HRESULT 성공 또는 오류 코드입니다.

## 설명

목록이 채워지면 플레이어를 선택할 수 있습니다. 플레이어는 선택기 UI에서 선택한 개인에게 지정된 게임 세션에 대한 게임 및/또는 파티 채팅 초대를 보낼 수 있습니다.

UI를 호출하면 게임이 *제한 모드(constrained mode)* 로 전환됩니다. 제한 모드에서는 호출된 UI의 백그라운드에 있는 동안 타이틀이 더 적은 시스템 리소스를 받게 됩니다. 제한 모드 및 타이틀의 기타 작동 모드에 대해 자세히 알아보려면 [XBOX 게임 수명 주기(NDA 항목)](/build/console-features/console-workflows/xbox-game-life-cycle)를 참조하세요.

## 요구 사항

**헤더:** XGameUI.h

**라이브러리:** xgameruntime.lib

**지원 플랫폼:** Windows, Steam Deck, XBOX One 계열 콘솔 및 XBOX Series 콘솔

## 개념 문서

* [비동기 프로그래밍 설계 목표 및 개선 사항](/build/core-features/common/async/async-whitepaper)
* [초대 보내기](/services/xbox-services/multiplayer/invites/how-to/live-invites-send)

## 함께 보기

[XGameUI](/reference/system/xgameui/xgameui_members)<br />[XGameUiShowSendGameInviteResult](/reference/system/xgameui/functions/xgameuishowsendgameinviteresult)<br />[XBOX 게임 수명 주기(NDA 항목)](/build/console-features/console-workflows/xbox-game-life-cycle)


## Related topics

- [XGameUiShowSendGameInviteUiCallback](/ko/reference/system/xgameui/functions/xgameuishowsendgameinviteuicallback.md)
- [XGameUiSetSendGameInviteUiResponse](/ko/reference/system/xgameui/functions/xgameuisetsendgameinviteuiresponse.md)
- [XGameUiUiCallbacks](/ko/reference/system/xgameui/structs/xgameuiuicallbacks.md)
- [MPSD에서 PlayFab Multiplayer 및 MPA로 이동](/ko/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [초대 보내기](/ko/services/xbox-services/multiplayer/invites/how-to/live-invites-send.md)