XblMultiplayerManagerJoinGame
전역적으로 고유한 세션 이름을 사용하여 게임 세션에 참가합니다.Syntax
Parameters
sessionName _In_z_Type: char* 게임 세션에 대한 전역적으로 고유한 세션 이름입니다. sessionTemplateName _In_z_
Type: char* 게임 세션의 기반이 될 세션 템플릿의 이름입니다. xuids _In_opt_
Type: uint64_t* 게임의 일부가 되기를 원하는 사용자를 나타내는 XBOX User ID(XUID) 배열입니다. xuidsCount _In_
Type: size_t
xuids에 지정된 배열의 요소 수입니다.
Return value
Type: HRESULT 이 API 작업에 대한 HRESULT 반환 코드입니다.Remarks
이 함수는xuids에 지정된 XBOX 사용자 목록을 sessionName에 지정된 전역적으로 고유한 세션 이름으로 식별된 게임 세션에 참가시킵니다. 타이틀의 타사 매치메이킹 결과에서 전역적으로 고유한 세션 이름을 얻을 수 있으며, 게임에 참가해야 하는 모든 클라이언트에 대해 이 함수를 호출해야 합니다. 이 함수의 결과는 이벤트 유형이
XblMultiplayerEventType::JoinGameCompleted로 설정된 멀티플레이어 이벤트로 전달됩니다. XblMultiplayerManagerDoWork를 호출하여 멀티플레이어 이벤트를 검색할 수 있습니다. 게임 세션에 참가하려고 할 때 서버가 가득 차면 서비스는
HTTP_E_STATUS_BAD_REQUEST를 반환합니다. 참가 후 XblMultiplayerManagerGameSessionSetProperties 또는 XblMultiplayerManagerGameSessionSetSynchronizedProperties를 호출하여 게임 세션의 속성을 설정하거나, XblMultiplayerManagerGameSessionSetSynchronizedHost를 호출하여 게임 세션의 호스트를 설정할 수 있습니다.