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

Cria um identificador de pesquisa associado a uma sessão existente. Isso torna a sessão consultável.

## Sintaxe

```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  
)  
```

### Parâmetros

*xblContext*   \_In\_\
Tipo: [XblContextHandle](https://devdocs.xbox.com/pt-BR/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

Contexto do XBOX Live para o usuário local.

*sessionRef*   \_In\_\
Tipo: [XblMultiplayerSessionReference\*](https://devdocs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreference.md)

Referência da sessão para a qual criar um identificador de pesquisa.

*tags*   \_In\_reads\_opt\_(tagsCount)\
Tipo: [XblMultiplayerSessionTag\*](https://devdocs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessiontag.md)

Conjunto opcional de marcas a serem anexadas ao identificador de pesquisa.

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

Contagem de marcas.

*numberAttributes*   \_In\_reads\_opt\_(numberAttributesCount)\
Tipo: [XblMultiplayerSessionNumberAttribute\*](https://devdocs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionnumberattribute.md)

Atributos opcionais a serem anexados ao identificador de pesquisa.

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

Contagem de atributos numéricos.

*stringAttributes*   \_In\_reads\_opt\_(stringAttributesCount)\
Tipo: [XblMultiplayerSessionStringAttribute\*](https://devdocs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionstringattribute.md)

Atributos opcionais a serem anexados ao identificador de pesquisa.

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

Contagem de atributos de cadeia de caracteres.

*async*   \_In\_\
Tipo: XAsyncBlock\*

O AsyncBlock para esta operação.

### Valor retornado

Tipo: HRESULT

Código de retorno HRESULT para esta operação de API.

## Requisitos

**Cabeçalho:** multiplayer\_c.h

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

## Confira também

[multiplayer\_c](https://devdocs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [XblMultiplayerCreateSearchHandleResult](https://devdocs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayercreatesearchhandleresult.md)
- [Navegação de sessões multiplayer](https://devdocs.xbox.com/pt-BR/services/xbox-services/multiplayer/concepts/live-session-browse.md)
- [XblMultiplayerGetSearchHandlesAsync](https://devdocs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsearchhandlesasync.md)
- [XblMultiplayerDeleteSearchHandleAsync](https://devdocs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerdeletesearchhandleasync.md)
- [XblMultiplayerGetSearchHandlesResult](https://devdocs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsearchhandlesresult.md)