Skip to main content

XblMultiplayerSendInvitesAsync

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

구문

매개 변수

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 수집(ingestion) 단계에서 표준 초대 텍스트에 추가되는 초대 텍스트를 식별하기 위해 정의됩니다. 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
마지막 수정일 2026년 8월 24일