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

Captura el objeto XblMultiplayerRole por nombre de tipo de rol y nombre de rol.

## Sintaxis

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

### Parámetros

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

Identificador de la sesión multijugador.

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

Nombre del tipo de rol al que pertenece el rol.

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

Nombre del rol.

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

Devuelve un puntero al objeto de rol con información sobre el rol. La memoria del puntero seguirá siendo válida durante la vigencia del objeto XblMultiplayerSessionHandle hasta que se cierre. Si no existe tal rol, se devolverá nullptr.

### Valor devuelto

Tipo: HRESULT

Código de retorno HRESULT de esta operación de API.

## Comentarios

Tenga en cuenta que las sesiones recién creadas no tendrán la información de roles rellenada hasta que se llame a XblMultiplayerWriteSessionAsync.

## Requisitos

**Encabezado:** multiplayer\_c.h

**Biblioteca:** Microsoft.Xbox.Services.14x.GDK.C.lib

## Consulte también

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


## Related topics

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