XblMultiplayerSessionGetRoleByName
역할 유형 이름 및 역할 이름으로 XblMultiplayerRole 개체를 가져옵니다.
구문
HRESULT XblMultiplayerSessionGetRoleByName(
XblMultiplayerSessionHandle handle,
const char* roleTypeName,
const char* roleName,
const XblMultiplayerRole** role
)
매개 변수
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