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

Busca sesiones por sus identificadores de búsqueda asociados.

## Sintaxis

```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](/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

Contexto de XBOX live del usuario local.

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

El identificador de configuración de servicio (SCID) en el que se consultan los identificadores de búsqueda. El SCID distingue mayúsculas de minúsculas, así que péguelo directamente desde el Partner Center

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

El nombre de la plantilla en la que se consultan los identificadores de búsqueda.

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

Especifica el atributo por el que se ordenan los identificadores de búsqueda. Pase una cadena vacía para usar la ordenación predeterminada 'Timestamp asc'.

*orderAscending*   \_In\_\
Tipo: bool

Pase true para ordenar de forma ascendente y false para ordenar de forma descendente.

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

La cadena de consulta para la que se obtienen los identificadores de búsqueda.

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

El grupo social para el que se obtienen los identificadores de búsqueda.

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

El AsyncBlock para esta operación.

### Valor devuelto

Tipo: HRESULT

Código de retorno HRESULT para esta operación de API.

## Comentarios

**Filtrado de identificadores de búsqueda:** la sintaxis de la consulta es similar a OData y solo admite los operadores EQ, NE, GE, GT, LE y LT, junto con los operadores lógicos AND y OR. Ejemplo 1: para filtrar los identificadores de búsqueda de un XboxUserId específico, use "MemberXuids/any(d:d eq '12345678')" o "OwnerXuids/any(d:d eq '12345678')" Ejemplo 2: para filtrar los identificadores de búsqueda de metadatos de cadena definidos por el título, use "Strings/stringMetadataType eq 'value'" Ejemplo 3: para filtrar los identificadores de búsqueda de metadatos numéricos definidos por el título Y un valor de tipo de etiqueta, use "Numbers/numberMetadataType eq 53 AND Tags/tagType eq 'value'" **Filtro y grupo social vacíos:** dado que searchFilter y socialGroup son opcionales, asegúrese de pasar un nullptr si no son necesarios o no se usan. Pasar una cadena vacía "" **no** funcionará.

## Requisitos

**Encabezado:** multiplayer\_c.h

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

## Consulte también

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


## Related topics

- [XblMultiplayerGetSearchHandlesResult](/es/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsearchhandlesresult.md)
- [XblMultiplayerGetSearchHandlesResultCount](/es/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsearchhandlesresultcount.md)
- [Migración de MPSD a PlayFab Multiplayer y MPA](/es/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [XblMultiplayerCreateSearchHandleAsync](/es/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayercreatesearchhandleasync.md)
- [XblMultiplayerDeleteSearchHandleAsync](/es/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerdeletesearchhandleasync.md)