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

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

## Syntaxe

```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  
)  
```

### Paramètres

*xblContext*   \_In\_\
Type : [XblContextHandle](/fr-CA/reference/live/xsapi-c/types_c/handles/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](/fr-CA/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [XblMultiplayerGetSearchHandlesResult](/fr-CA/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsearchhandlesresult.md)
- [XblMultiplayerGetSearchHandlesResultCount](/fr-CA/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsearchhandlesresultcount.md)
- [Passer de MPSD à PlayFab Multiplayer et MPA](/fr-CA/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [XblMultiplayerCreateSearchHandleAsync](/fr-CA/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayercreatesearchhandleasync.md)
- [XblMultiplayerDeleteSearchHandleAsync](/fr-CA/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerdeletesearchhandleasync.md)