Skip to main content

XblMultiplayerWriteSessionResult

XblMultiplayerWriteSessionAsync 작업의 결과를 가져옵니다.

구문

매개 변수

async   _Inout_
형식: XAsyncBlock*
이 작업에 대한 AsyncBlock입니다. handle   _Out_
형식: XblMultiplayerSessionHandle*
새 로컬 멀티플레이어 세션 객체 인스턴스에 대한 핸들을 반환합니다. 호출자는 XblMultiplayerSessionCloseHandle을 호출하여 XblMultiplayerSessionHandle을 해제해야 합니다. XblMultiplayerSession* API를 사용하여 핸들에서 세션 데이터를 가져옵니다. 업데이트된 세션 객체가 필요하지 않은 경우 nullptr을 전달하면 새 멀티플레이어 세션 객체가 즉시 정리됩니다.

반환값

형식: HRESULT 이 API 작업에 대한 HRESULT 반환 코드입니다. 네트워크 오류가 있거나 실패 HTTP 상태 코드가 있는 경우 실패 HRESULT가 됩니다. 단, 412(Precondition Failed)는 예외입니다. 412 응답은 서비스가 최신 세션 상태도 반환하므로 성공을 반환하며, 따라서 XblMultiplayerSessionWriteStatus()를 호출하여 쓰기 상태를 확인하고 XblMultiplayerSession* API를 호출하여 핸들에서 세션 데이터를 가져와야 합니다.

설명

자신이 마지막 멤버인 세션에서 나가고 sessionEmptyTimeout이 0인 경우, 세션이 즉시 삭제됩니다. XblMultiplayerSessionWriteStatus()를 호출하여 쓰기 상태를 가져옵니다.

요구 사항

헤더: multiplayer_c.h 라이브러리: Microsoft.Xbox.Services.14x.GDK.C.lib

함께 보기

multiplayer_c
마지막 수정일 2026년 8월 13일