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

Busca o objeto XblMultiplayerRole pelo nome do tipo de função e pelo nome da função.

## Sintaxe

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

### Parâmetros

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

Identificador da sessão multijogador.

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

Nome do tipo de função ao qual a função pertence.

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

Nome da função.

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

Retorna um ponteiro para o objeto de função com informações sobre a função. A memória do ponteiro permanecerá válida durante a vida útil do objeto XblMultiplayerSessionHandle, até que ele seja fechado. Se essa função não existir, nullptr será retornado.

### Valor retornado

Tipo: HRESULT

Código de retorno HRESULT desta operação de API.

## Comentários

Observe que as sessões recém-criadas não terão as informações de função preenchidas até que XblMultiplayerWriteSessionAsync seja chamado.

## Requisitos

**Cabeçalho:** multiplayer\_c.h

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

## Confira também

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


## Related topics

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