> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblMultiplayerWriteSessionByHandleAsync

> XblMultiplayerWriteSessionByHandleAsync

# XblMultiplayerWriteSessionByHandleAsync

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

## 구문

```cpp theme={null}
HRESULT XblMultiplayerWriteSessionByHandleAsync(  
         XblContextHandle xblContext,  
         XblMultiplayerSessionHandle multiplayerSession,  
         XblMultiplayerSessionWriteMode writeMode,  
         const char* handleId,  
         XAsyncBlock* async  
)  
```

### 매개 변수

*xblContext*   \_In\_\
형식: [XblContextHandle](/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

로컬 사용자의 XBOX live 컨텍스트입니다.

*multiplayerSession*   \_In\_\
형식: [XblMultiplayerSessionHandle](/reference/live/xsapi-c/multiplayer_c/handles/xblmultiplayersessionhandle)

쓸 변경 사항으로 수정된 MultiplayerSession 객체입니다.

*writeMode*   \_In\_\
형식: [XblMultiplayerSessionWriteMode](/reference/live/xsapi-c/multiplayer_c/enums/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

## 개념 문서

* [초대 수신](/services/xbox-services/multiplayer/invites/how-to/live-invites-receive)

## 함께 보기

[multiplayer\_c](/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [XblMultiplayerSessionWriteMode](/ko/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionwritemode.md)
- [XblMultiplayerWriteSessionAsync](/ko/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionasync.md)
- [초대 받기](/ko/services/xbox-services/multiplayer/invites/how-to/live-invites-receive.md)
- [Multiplayer Session Directory 개요](/ko/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [MPSD에서 PlayFab Multiplayer 및 MPA로 이동](/ko/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)