Passer au contenu principal

XblMultiplayerSessionGetRoleByName

Récupère l’objet XblMultiplayerRole par nom de type de rôle et nom de rôle.

Syntaxe

Paramètres

handle   _In_
Type : 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**
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 aucun rôle de ce type n’existe, 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
Dernière modification le 6 octobre 2026