Skip to main content

XblMultiplayerSessionGetRoleByName

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

구문

매개 변수

handle   _In_
형식: XblMultiplayerSessionHandle
멀티플레이어 세션에 대한 핸들입니다. roleTypeName   _In_z_
형식: char*
역할이 속한 역할 유형의 이름입니다. roleName   _In_z_
형식: char*
역할의 이름입니다. role   _Out_
형식: XblMultiplayerRole**
역할에 대한 정보를 포함하는 역할 개체에 대한 포인터를 반환합니다. 포인터의 메모리는 XblMultiplayerSessionHandle 개체가 닫힐 때까지 유효합니다. 해당 역할이 없으면 nullptr가 반환됩니다.

반환값

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

설명

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

요구 사항

헤더: multiplayer_c.h 라이브러리: Microsoft.Xbox.Services.14x.GDK.C.lib

함께 보기

multiplayer_c
마지막 수정일 2026년 8월 13일