Pular para o conteúdo principal

XblMultiplayerGetSearchHandlesAsync

Pesquisa sessões pelos identificadores de pesquisa associados.

Sintaxe

Parâmetros

xblContext   _In_
Tipo: 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
Última modificação em 6 de outubro de 2026