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

# XblMultiplayerGetSessionByHandleAsync

> XblMultiplayerGetSessionByHandleAsync

# XblMultiplayerGetSessionByHandleAsync

세션 핸들 ID가 주어지면, 그에 해당하는 세션 객체와 모든 속성을 서버에서 가져옵니다.

## Syntax

```cpp theme={null}
HRESULT XblMultiplayerGetSessionByHandleAsync(  
         XblContextHandle xblContext,  
         const char* handleId,  
         XAsyncBlock* async  
)  
```

### Parameters

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

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

*handleId*   \_In\_\
Type: char\*

세션을 고유하게 식별하는 멀티플레이어 핸들 ID입니다.

*async*   \_In\_\
Type: XAsyncBlock\*

이 작업에 대한 AsyncBlock입니다.

### Return value

Type: HRESULT

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

## Remarks

핸들은 세션에 대한 서비스 측 포인터입니다. handleId는 핸들의 GUID 식별자입니다. 호출자는 일반적으로 다른 플레이어의 XblMultiplayerActivityDetails 또는 초대에서 handleId를 얻게 됩니다.

## REST Call

GET /handles/{handleId}/session을 호출합니다.

## Requirements

**Header:** multiplayer\_c.h

**Library:** Microsoft.Xbox.Services.14x.GDK.C.lib

## Conceptual documentation

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

## See also

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


## Related topics

- [XblMultiplayerGetSessionByHandleResult](/ko/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsessionbyhandleresult.md)
- [초대 받기](/ko/services/xbox-services/multiplayer/invites/how-to/live-invites-receive.md)
- [MPSD에서 PlayFab Multiplayer 및 MPA로 이동](/ko/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [멀티플레이어 FAQ 및 문제 해결](/ko/services/xbox-services/multiplayer/mpsd/concepts/live-multiplayer-2015-faq.md)
- [XblMultiplayerGetSessionAsync](/ko/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsessionasync.md)