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

역할 유형 이름과 역할 이름으로 XblMultiplayerRole 개체를 가져옵니다.

## 구문

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

### 매개 변수

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

멀티플레이어 세션에 대한 핸들입니다.

*roleTypeName*   \_In\_z\_\
형식: char\*

역할이 속한 역할 유형의 이름입니다.

*roleName*   \_In\_z\_\
형식: char\*

역할의 이름입니다.

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

역할에 대한 정보를 포함하는 역할 개체에 대한 포인터를 반환합니다. 포인터의 메모리는 XblMultiplayerSessionHandle 개체가 닫힐 때까지 유효합니다. 해당 역할이 없으면 nullptr가 반환됩니다.

### 반환값

형식: HRESULT

이 API 작업에 대한 HRESULT 반환 코드입니다.

## 설명

새로 만들어진 세션은 XblMultiplayerWriteSessionAsync가 호출될 때까지 역할 정보가 채워지지 않습니다.

## 요구 사항

**헤더:** multiplayer\_c.h

**라이브러리:** Microsoft.Xbox.Services.14x.GDK.C.lib

## 함께 보기

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


## Related topics

- [XblMultiplayerSessionMemberRole](/ko/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionmemberrole.md)
- [XblMultiplayerSessionSetMutableRoleSettings](/ko/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionsetmutablerolesettings.md)
- [XblMultiplayerSessionRoleTypes](/ko/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionroletypes.md)
- [XblMultiplayerSessionCurrentUserSetRoles](/ko/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessioncurrentusersetroles.md)
- [XblMultiplayerGetSessionResult](/ko/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsessionresult.md)