다음을 통해 공유


XblMultiplayerActivitySendInvitesAsync

호출자를 현재 활동에 참여시키기 위해 Xbox 사용자 ID에 초대를 보냅니다.

구문

HRESULT XblMultiplayerActivitySendInvitesAsync(  
         XblContextHandle xblContext,  
         const uint64_t* xuids,  
         size_t xuidsCount,  
         bool allowCrossPlatformJoin,  
         const char* connectionString,  
         XAsyncBlock* async  
)  

매개 변수

xblContext _In_
형식: XblContextHandle

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

xuids _In_
형식: uint64_t*

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

xuidsCount _In_
형식: size_t

xuids 배열 크기입니다.

allowCrossPlatformJoin _In_
형식: bool

플랫폼 간 초대에 대해 브라우저가 구성된 경우 이 매개 변수를 true로 설정하면 타이틀이 지원하는 모든 플랫폼 끝점에 초대가 전송됩니다. false로 설정하면 보낸 사람의 플랫폼에만 초대가 전송됩니다. 플랫폼 간 초대가 구성되지 않은 경우 초대는 항상 보낸 사람의 플랫폼에만 전송됩니다.

connectionString _In_opt_z_
형식: char*

(선택 사항) 피어가 게임에 참여하는 데 사용할 연결 문자열입니다.

async _In_
형식: XAsyncBlock*

이 작업에 대한 XAsyncBlock입니다.

반환 값

형식: HRESULT

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

설명

비동기식 작업의 결과를 가져오려면 XAsyncBlock 콜백 내에서 또는 XAsyncBlock이(가) 완료된 후에 XAsyncGetStatus를 호출합니다.

이 함수 사용 방법을 확인하려면 멀티 플레이어 활동 코드 예시활동 섹션에서 "초대 전송"을 참조하세요.

멀티 플레이 활동에 대한 자세한 내용은 활동을 참조하세요.

REST 호출

POST /titles/{titleId}/invites를 호출합니다.

요구 사항

헤더: multiplayer_activity_c.h

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

참고 항목

multiplayer_activity_c