Skip to main content

XblMultiplayerActivitySendInvitesAsync

XBOX 사용자 ID에 호출자의 현재 활동에 참여하도록 초대를 보냅니다.

Syntax

Parameters

xblContext   _In_
Type: XblContextHandle
로컬 사용자의 XBOX Live 컨텍스트입니다. xuids   _In_
Type: uint64_t*
초대할 XBOX 사용자 ID 목록입니다. xuidsCount   _In_
Type: size_t
xuids 배열의 크기입니다. allowCrossPlatformJoin   _In_
Type: bool
타이틀이 크로스 플랫폼 초대에 대해 구성되어 있으면 이 매개 변수를 true로 설정하면 타이틀이 지원하는 모든 플랫폼 엔드포인트에 초대가 전송됩니다. false로 설정하면 발신자의 플랫폼에만 초대가 전송됩니다. 크로스 플랫폼 초대가 구성되어 있지 않으면 초대는 항상 발신자의 플랫폼으로만 전송됩니다. connectionString   _In_opt_z_
Type: char*
(선택 사항) 피어가 게임에 참여하는 데 사용하는 연결 문자열입니다. async   _In_
Type: XAsyncBlock*
이 작업에 대한 XAsyncBlock입니다.

Return value

Type: HRESULT 이 API 작업의 HRESULT 반환 코드입니다.

Remarks

비동기 작업의 결과를 가져오려면 XAsyncBlock 콜백 내부에서 또는 XAsyncBlock이 완료된 후에 XAsyncGetStatus를 호출하세요.

이 함수가 어떻게 사용되는지 보려면 멀티플레이어 활동 예제 코드Invites 섹션에서 “Sending invites”를 참조하세요.

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

REST Call

POST /titles//invites를 호출합니다.

Requirements

Header: multiplayer_activity_c.h Library: Microsoft.Xbox.Services.14x.GDK.C.lib

See also

multiplayer_activity_c
마지막 수정일 2026년 8월 24일