다음을 통해 공유


XblMultiplayerSendInvitesAsync

지정된 사용자를 세션에 초대합니다. 그러면 표준 초대 텍스트를 사용하여 초대된 각 사용자에게 알림이 표시됩니다. 사용자가 알림을 수락하면 타이틀이 활성화됩니다.

구문

HRESULT XblMultiplayerSendInvitesAsync(  
         XblContextHandle xblContext,  
         const XblMultiplayerSessionReference* sessionReference,  
         const uint64_t* xuids,  
         size_t xuidsCount,  
         uint32_t titleId,  
         const char* contextStringId,  
         const char* customActivationContext,  
         XAsyncBlock* async  
)  

매개 변수

xblContext _In_
형식: XblContextHandle

로컬 사용자용 Xbox Live 컨텍스트입니다.

sessionReference _In_
형식: XblMultiplayerSessionReference*

대상 사용자가 초대되는 세션을 나타내는 XblMultiplayerSessionReference 개체입니다.

xuids _In_
형식: uint64_t*

초대할 Xbox 사용자 ID 목록입니다.

xuidsCount _In_
형식: size_t

xuids 배열의 크기입니다.

titleId _In_
형식: uint32_t

세션에 참가하기 위해 초대된 사용자가 활성화할 타이틀의 ID입니다.

contextStringId _In_opt_z_
형식: char*

사용자 지정 컨텍스트 문자열 ID입니다. 이 문자열 ID는 표준 초대 텍스트에 추가로 초대 텍스트를 식별하기 위해 Xbox Live 수집 중에 정의됩니다. ID 문자열에는 " /// " 접두사가 필요합니다. 사용자 지정 문자열을 초대에 추가하지 않으려면 nullptr을 전달합니다.

customActivationContext _In_opt_z_
형식: char*

활성화 컨텍스트 문자열입니다. 초대된 게임 클라이언트로 전달되어 원하는 대로 해석되는 게임 정의 문자열입니다. (선택 사항)

async _In_
형식: XAsyncBlock*

이 작업에 대한 AsyncBlock입니다.

반환 값

형식: HRESULT

이 API 작업에 대한 HRESULT 반환 코드입니다.

요구 사항

헤더: multiplayer_c.h

도서관: Microsoft.Xbox.Services.14x.GDK.C.lib

참고 항목

multiplayer_c