> ## 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.

# XblMultiplayerWriteSessionAsync

> XblMultiplayerWriteSessionAsync

# XblMultiplayerWriteSessionAsync

새 멀티플레이어 세션 또는 업데이트된 멀티플레이어 세션을 서비스에 씁니다. 세션에는 유효한 세션 참조가 있어야 합니다. 세션 참조 없이 만들어진 세션인 경우 대신 XblMultiplayerWriteSessionByHandleAsync를 사용합니다.

## 구문

```cpp theme={null}
HRESULT XblMultiplayerWriteSessionAsync(  
         XblContextHandle xblContext,  
         XblMultiplayerSessionHandle multiplayerSession,  
         XblMultiplayerSessionWriteMode writeMode,  
         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)

쓰기 작업의 유형입니다.

*async*   \_Inout\_\
형식: XAsyncBlock\*

이 작업에 대한 AsyncBlock입니다.

### 반환값

형식: HRESULT

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

## 설명

비동기 콜백에서 XblMultiplayerWriteSessionResult()를 호출하여 XblMultiplayerSessionHandle 핸들을 가져옵니다. 그런 다음 해당 핸들을 사용하여 XblMultiplayerSessionWriteStatus()를 호출하여 쓰기 상태를 가져옵니다. XblMultiplayerWriteSessionAsync() 호출은 전달된 인수가 잘못된 경우 또는 매우 드물게 비동기 작업을 시작할 수 없는 경우에만 실패합니다.

## REST 호출

V105 PUT /serviceconfigs/{serviceConfigurationId}/sessionTemplates/{sessiontemplateName}/sessions/{sessionName}를 호출합니다.

## 요구 사항

**헤더:** multiplayer\_c.h

**라이브러리:** Microsoft.Xbox.Services.14x.GDK.C.lib

## 함께 보기

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


## Related topics

- [XblMultiplayerSessionWriteMode](/ko/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionwritemode.md)
- [XblMultiplayerWriteSessionResult](/ko/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionresult.md)
- [XblMultiplayerSessionWriteStatus](/ko/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionwritestatus.md)
- [XblMultiplayerWriteSessionByHandleResult](/ko/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionbyhandleresult.md)
- [XblMultiplayerSessionCreateHandle](/ko/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessioncreatehandle.md)