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

# XblMultiplayerCreateSearchHandleAsync

> XblMultiplayerCreateSearchHandleAsync

# XblMultiplayerCreateSearchHandleAsync

기존 세션과 연결된 검색 핸들을 생성합니다. 이렇게 하면 세션이 쿼리 가능하게 됩니다.

## Syntax

```cpp theme={null}
HRESULT XblMultiplayerCreateSearchHandleAsync(  
         XblContextHandle xblContext,  
         const XblMultiplayerSessionReference* sessionRef,  
         const XblMultiplayerSessionTag* tags,  
         size_t tagsCount,  
         const XblMultiplayerSessionNumberAttribute* numberAttributes,  
         size_t numberAttributesCount,  
         const XblMultiplayerSessionStringAttribute* stringAttributes,  
         size_t stringAttributesCount,  
         XAsyncBlock* async  
)  
```

### Parameters

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

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

*sessionRef*   \_In\_\
Type: [XblMultiplayerSessionReference\*](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreference)

검색 핸들을 생성할 세션 참조입니다.

*tags*   \_In\_reads\_opt\_(tagsCount)\
Type: [XblMultiplayerSessionTag\*](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessiontag)

검색 핸들에 첨부할 선택적 태그 세트입니다.

*tagsCount*   \_In\_\
Type: size\_t

태그의 개수입니다.

*numberAttributes*   \_In\_reads\_opt\_(numberAttributesCount)\
Type: [XblMultiplayerSessionNumberAttribute\*](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionnumberattribute)

검색 핸들에 첨부할 선택적 속성입니다.

*numberAttributesCount*   \_In\_\
Type: size\_t

숫자 속성의 개수입니다.

*stringAttributes*   \_In\_reads\_opt\_(stringAttributesCount)\
Type: [XblMultiplayerSessionStringAttribute\*](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionstringattribute)

검색 핸들에 첨부할 선택적 속성입니다.

*stringAttributesCount*   \_In\_\
Type: size\_t

문자열 속성의 개수입니다.

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

이 작업에 대한 AsyncBlock입니다.

### Return value

Type: HRESULT

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

## Requirements

**Header:** multiplayer\_c.h

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

## See also

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


## Related topics

- [XblMultiplayerCreateSearchHandleResult](/ko/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayercreatesearchhandleresult.md)
- [XblMultiplayerDeleteSearchHandleAsync](/ko/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerdeletesearchhandleasync.md)
- [XblMultiplayerGetSearchHandlesAsync](/ko/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsearchhandlesasync.md)
- [XblMultiplayerGetSearchHandlesResult](/ko/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsearchhandlesresult.md)
- [XblMultiplayerGetSearchHandlesResultCount](/ko/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsearchhandlesresultcount.md)