XblMultiplayerWriteSessionByHandleAsync
세션에 대한 지정된 핸들을 사용하여 서비스에 신규 또는 업데이트된 멀티플레이어 세션을 기록합니다.
구문
HRESULT XblMultiplayerWriteSessionByHandleAsync(
XblContextHandle xblContext,
XblMultiplayerSessionHandle multiplayerSession,
XblMultiplayerSessionWriteMode writeMode,
const char* handleId,
XAsyncBlock* async
)
매개 변수
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