Passer au contenu principal

XblMultiplayerGetSearchHandlesAsync

Recherche des sessions à l’aide de leurs handles de recherche associés.

Syntaxe

Paramètres

xblContext   _In_
Type : XblContextHandle
Contexte XBOX Live de l’utilisateur local. scid   _In_z_
Type : char*
L’identifiant de configuration de service (SCID) dans lequel interroger les handles de recherche. Le SCID respecte la casse; collez-le donc directement à partir de Partner Center sessionTemplateName   _In_z_
Type : char*
Le nom du modèle dans lequel interroger les handles de recherche. orderByAttribute   _In_opt_z_
Type : char*
Indique l’attribut selon lequel trier les handles de recherche. Passez une chaîne vide pour utiliser le tri par défaut ‘Timestamp asc’. orderAscending   _In_
Type : bool
Passez true pour un tri croissant, false pour un tri décroissant. searchFilter   _In_opt_z_
Type : char*
La chaîne de requête pour laquelle obtenir les handles de recherche. socialGroup   _In_opt_z_
Type : char*
Le groupe social pour lequel obtenir les handles de recherche. async   _In_
Type : XAsyncBlock*
L’AsyncBlock pour cette opération.

Valeur de retour

Type : HRESULT Code de retour HRESULT pour cette opération d’API.

Remarques

Filtrage des handles de recherche : La syntaxe de requête est semblable à OData et prend uniquement en charge les opérateurs EQ, NE, GE, GT, LE et LT, ainsi que les opérateurs logiques AND et OR. Exemple 1 : Pour filtrer les handles de recherche d’un XboxUserId précis, utilisez “MemberXuids/any(d:d eq ‘12345678’)” ou “OwnerXuids/any(d:d eq ‘12345678’)” Exemple 2 : Pour filtrer les handles de recherche selon des métadonnées de chaîne définies par le titre, utilisez “Strings/stringMetadataType eq ‘value’” Exemple 3 : Pour filtrer les handles de recherche selon des métadonnées numériques définies par le titre ET une valeur de type d’étiquette, utilisez “Numbers/numberMetadataType eq 53 AND Tags/tagType eq ‘value’” Filtre et groupe social vides : Puisque searchFilter et socialGroup sont facultatifs, assurez-vous de passer nullptr s’ils ne sont pas nécessaires ou utilisés. Passer une chaîne vide "" ne fonctionnera pas.

Configuration requise

En-tête : multiplayer_c.h Bibliothèque : Microsoft.Xbox.Services.14x.GDK.C.lib

Voir aussi

multiplayer_c
Dernière modification le 6 octobre 2026