Skip to main content

XblMultiplayerWriteSessionByHandleAsync

지정된 세션에 대한 핸들을 사용하여 새 멀티플레이어 세션 또는 업데이트된 멀티플레이어 세션을 서비스에 씁니다.

구문

매개 변수

xblContext   _In_
형식: XblContextHandle
로컬 사용자의 XBOX live 컨텍스트입니다. multiplayerSession   _In_
형식: XblMultiplayerSessionHandle
쓸 변경 사항으로 수정된 MultiplayerSession 객체입니다. writeMode   _In_
형식: XblMultiplayerSessionWriteMode
쓰기 작업의 유형입니다. handleId   _In_
형식: char*
세션을 쓸 때 사용할 핸들의 ID입니다. async   _In_
형식: XAsyncBlock*
이 작업에 대한 AsyncBlock입니다.

반환값

형식: HRESULT 이 API 작업에 대한 HRESULT 반환 코드입니다.

설명

핸들은 세션에 대한 서비스 측 포인터입니다. 핸들 ID는 핸들의 GUID 식별자입니다. 호출자는 일반적으로 XblMultiplayerGetActivitiesForUsersAsync() API를 통해 다른 플레이어의 XblMultiplayerActivityDetails에서 handleId를 얻거나 초대에서 얻습니다. 핸들의 수명이 그것이 가리키는 세션의 수명보다 짧을 수 있으므로, 멀티플레이어 세션 객체에 유효한 XblMultiplayerSessionReference가 없는 경우에만 이 메서드를 사용합니다.

요구 사항

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

개념 문서

함께 보기

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