XblMultiplayerManagerJoinGame
전역적으로 고유한 세션 이름을 사용하여 게임 세션에 참가합니다.
구문
HRESULT XblMultiplayerManagerJoinGame(
const char* sessionName,
const char* sessionTemplateName,
const uint64_t* xuids,
size_t xuidsCount
)
매개 변수
sessionName _In_z_
형식: char*
전역적으로 고유한 게임 세션 이름입니다.
sessionTemplateName _In_z_
형식: char*
기준으로 사용할 게임 세션에 대한 세션 템플릿 이름입니다.
xuids _In_opt_
형식: uint64_t*
게임에 참여하려는 사용자를 나타내는 Xbox 사용자 ID(XUID) 배열입니다.
xuidsCount _In_
형식: size_t
xuids에 대해 지정된 배열에 있는 요소 수입니다.
반환 값
형식: HRESULT
이 API 작업에 대한 HRESULT 반환 코드입니다.
비고
이 함수는 xuids에 지정된 Xbox 사용자 목록을 sessionName.에 지정된 전역적으로 고유한 세션 이름으로 식별되는 게임 세션에 연결합니다. 타이틀의 타사 매치메이킹 결과에서 전역적으로 고유한 세션 이름을 가져올 수 있으며 게임에 참가해야 하는 모든 클라이언트에 대해 이 함수를 호출해야 합니다.
이 함수의 결과는 이벤트 유형이 XblMultiplayerEventType::JoinGameCompleted(으)로 설정된 멀티 플레이어 이벤트로 전달됩니다.
XblMultiplayerManagerDoWork를 호출하여 멀티 플레이어 이벤트를 검색할 수 있습니다.
게임 세션에 참가하려고 할 경우 서버가 가득 차면 서비스가 HTTP_E_STATUS_BAD_REQUEST을(를) 반환합니다.
참가한 후 XblMultiplayerManagerGameSessionSetProperties 또는 XblMultiplayerManagerGameSessionSetSynchronizedProperties를 호출하여 게임 세션의 속성을 설정하거나 할 수 있습니다. 또는 XblMultiplayerManagerGameSessionSetSynchronizedHost를 호출하여 게임 세션에 대한 호스트를 설정할 수 있습니다.
요구 사항
헤더: multiplayer_manager_c.h
도서관: Microsoft.Xbox.Services.14x.GDK.C.lib