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

# XblMultiplayerCreateSearchHandleAsync

> XblMultiplayerCreateSearchHandleAsync

# XblMultiplayerCreateSearchHandleAsync

Crée un descripteur de recherche associé à une session existante. La session peut ainsi être interrogée.

## Syntaxe

```cpp theme={null}
HRESULT XblMultiplayerCreateSearchHandleAsync(  
         XblContextHandle xblContext,  
         const XblMultiplayerSessionReference* sessionRef,  
         const XblMultiplayerSessionTag* tags,  
         size_t tagsCount,  
         const XblMultiplayerSessionNumberAttribute* numberAttributes,  
         size_t numberAttributesCount,  
         const XblMultiplayerSessionStringAttribute* stringAttributes,  
         size_t stringAttributesCount,  
         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.

*sessionRef*   \_In\_\
Type : [XblMultiplayerSessionReference\*](/fr-CA/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreference)

Référence de la session pour laquelle créer un descripteur de recherche.

*tags*   \_In\_reads\_opt\_(tagsCount)\
Type : [XblMultiplayerSessionTag\*](/fr-CA/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessiontag)

Ensemble facultatif de balises à associer au descripteur de recherche.

*tagsCount*   \_In\_\
Type : size\_t

Nombre de balises.

*numberAttributes*   \_In\_reads\_opt\_(numberAttributesCount)\
Type : [XblMultiplayerSessionNumberAttribute\*](/fr-CA/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionnumberattribute)

Attributs facultatifs à associer au descripteur de recherche.

*numberAttributesCount*   \_In\_\
Type : size\_t

Nombre d'attributs numériques.

*stringAttributes*   \_In\_reads\_opt\_(stringAttributesCount)\
Type : [XblMultiplayerSessionStringAttribute\*](/fr-CA/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionstringattribute)

Attributs facultatifs à associer au descripteur de recherche.

*stringAttributesCount*   \_In\_\
Type : size\_t

Nombre d'attributs de chaîne.

*async*   \_In\_\
Type : XAsyncBlock\*

Le AsyncBlock pour cette opération.

### Valeur de retour

Type : HRESULT

Code de retour HRESULT pour cette opération d'API.

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

- [XblMultiplayerCreateSearchHandleResult](/fr-CA/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayercreatesearchhandleresult.md)
- [Parcours des sessions multijoueurs](/fr-CA/services/xbox-services/multiplayer/concepts/live-session-browse.md)
- [XblMultiplayerDeleteSearchHandleAsync](/fr-CA/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerdeletesearchhandleasync.md)
- [XblMultiplayerGetSearchHandlesAsync](/fr-CA/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsearchhandlesasync.md)
- [XblMultiplayerGetSearchHandlesResult](/fr-CA/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsearchhandlesresult.md)