Skip to main content

XblMultiplayerGetSearchHandlesAsync

Busca sesiones por sus identificadores de búsqueda asociados.

Sintaxis

Parámetros

xblContext   _In_
Tipo: 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
Última modificación el 28 de agosto de 2026