Skip to main content

XblMultiplayerSessionSetMutableRoleSettings

역할에 대한 최대 멤버 수 및/또는 목표 멤버 수를 설정합니다.

구문

매개 변수

handle   _In_
형식: XblMultiplayerSessionHandle
멀티플레이어 세션에 대한 핸들입니다. roleTypeName   _In_z_
형식: char*
수정할 역할의 역할 형식 이름입니다. roleName   _In_z_
형식: char*
수정할 역할의 이름입니다. maxMemberCount   _In_opt_
형식: uint32_t*
해당 역할을 가질 수 있는 최대 멤버 수입니다. targetMemberCount   _In_opt_
형식: uint32_t*
해당 역할의 목표 멤버 수입니다.

반환값

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

설명

세션 소유자만 역할 설정을 수정할 수 있으며, 수정 가능한 설정만 변경할 수 있습니다(XblMultiplayerRoleType.MutableRoleSettings 참조). 세션 템플릿에서 수정하려는 특정 역할 형식에 대해 ‘hasOwners’ 기능과 ‘ownerManaged’를 true로 설정해야 합니다.

요구 사항

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

함께 보기

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