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

# XblMultiplayerGetSearchHandlesAsync

> XblMultiplayerGetSearchHandlesAsync

# XblMultiplayerGetSearchHandlesAsync

Pesquisa sessões pelos identificadores de pesquisa associados.

## Sintaxe

```cpp theme={null}
HRESULT XblMultiplayerGetSearchHandlesAsync(  
         XblContextHandle xblContext,  
         const char* scid,  
         const char* sessionTemplateName,  
         const char* orderByAttribute,  
         bool orderAscending,  
         const char* searchFilter,  
         const char* socialGroup,  
         XAsyncBlock* async  
)  
```

### Parâmetros

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

Contexto do XBOX Live para o usuário local.

*scid*   \_In\_z\_\
Tipo: char\*

A ID de configuração de serviço (SCID) na qual consultar os identificadores de pesquisa. O SCID diferencia maiúsculas de minúsculas, portanto, cole-o diretamente do Partner Center

*sessionTemplateName*   \_In\_z\_\
Tipo: char\*

O nome do modelo no qual consultar os identificadores de pesquisa.

*orderByAttribute*   \_In\_opt\_z\_\
Tipo: char\*

Especifica o atributo pelo qual classificar os identificadores de pesquisa. Passe uma cadeia de caracteres vazia para usar a ordenação padrão por 'Timestamp asc'.

*orderAscending*   \_In\_\
Tipo: bool

Passe true para ordem crescente ou false para ordem decrescente.

*searchFilter*   \_In\_opt\_z\_\
Tipo: char\*

A cadeia de caracteres de consulta para a qual obter os identificadores de pesquisa.

*socialGroup*   \_In\_opt\_z\_\
Tipo: char\*

O grupo social para o qual obter os identificadores de pesquisa.

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

O AsyncBlock para esta operação.

### Valor retornado

Tipo: HRESULT

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

## Comentários

**Filtragem de identificadores de pesquisa:** a sintaxe de consulta é semelhante à do OData, com suporte apenas aos seguintes operadores: EQ, NE, GE, GT, LE e LT, além dos operadores lógicos AND e OR. Exemplo 1: para filtrar identificadores de pesquisa de um XboxUserId específico, use "MemberXuids/any(d:d eq '12345678')" ou "OwnerXuids/any(d:d eq '12345678')" Exemplo 2: para filtrar identificadores de pesquisa por metadados de cadeia de caracteres definidos pelo título, use "Strings/stringMetadataType eq 'value'" Exemplo 3: para filtrar identificadores de pesquisa por metadados numéricos definidos pelo título E um valor de tipo de marca, use "Numbers/numberMetadataType eq 53 AND Tags/tagType eq 'value'" **Filtro e grupo social vazios:** como searchFilter e socialGroup são opcionais, certifique-se de passar nullptr se eles não forem necessários/usados. Passar uma cadeia de caracteres vazia "" **não** funcionará.

## Requisitos

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

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

## Confira também

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


## Related topics

- [XblMultiplayerGetSearchHandlesResult](/pt-BR/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsearchhandlesresult.md)
- [XblMultiplayerGetSearchHandlesResultCount](/pt-BR/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsearchhandlesresultcount.md)
- [Migrando do MPSD para o PlayFab Multiplayer e o MPA](/pt-BR/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [XblMultiplayerDeleteSearchHandleAsync](/pt-BR/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerdeletesearchhandleasync.md)
- [XblMultiplayerCreateSearchHandleAsync](/pt-BR/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayercreatesearchhandleasync.md)