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

# XblMultiplayerSessionGetRoleByName

> XblMultiplayerSessionGetRoleByName

# XblMultiplayerSessionGetRoleByName

Récupère l'objet XblMultiplayerRole à partir du nom du type de rôle et du nom du rôle.

## Syntaxe

```cpp theme={null}
HRESULT XblMultiplayerSessionGetRoleByName(  
         XblMultiplayerSessionHandle handle,  
         const char* roleTypeName,  
         const char* roleName,  
         const XblMultiplayerRole** role  
)  
```

### Paramètres

*handle*   \_In\_\
Type : [XblMultiplayerSessionHandle](/fr/reference/live/xsapi-c/multiplayer_c/handles/xblmultiplayersessionhandle)

Handle de la session multijoueur.

*roleTypeName*   \_In\_z\_\
Type : char\*

Nom du type de rôle auquel le rôle appartient.

*roleName*   \_In\_z\_\
Type : char\*

Nom du rôle.

*role*   \_Out\_\
Type : [XblMultiplayerRole\*\*](/fr/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayerrole)

Retourne un pointeur vers l'objet de rôle contenant les informations sur le rôle. La mémoire du pointeur reste valide pendant toute la durée de vie de l'objet XblMultiplayerSessionHandle, jusqu'à sa fermeture. Si ce rôle n'existe pas, nullptr est retourné.

### Valeur de retour

Type : HRESULT

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

## Remarques

Notez que les informations de rôle des sessions nouvellement créées ne sont pas renseignées tant que XblMultiplayerWriteSessionAsync n'a pas été appelé.

## Configuration requise

**En-tête :** multiplayer\_c.h

**Bibliothèque :** Microsoft.Xbox.Services.14x.GDK.C.lib

## Voir aussi

[multiplayer\_c](/fr/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [XblMultiplayerSessionMemberRole](/fr/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionmemberrole.md)
- [XblMultiplayerSessionSetMutableRoleSettings](/fr/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionsetmutablerolesettings.md)
- [XblMultiplayerSessionRoleTypes](/fr/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionroletypes.md)
- [XblMultiplayerSessionCurrentUserSetRoles](/fr/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessioncurrentusersetroles.md)
- [XblMultiplayerSessionGetInfo](/fr/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessiongetinfo.md)