PFLobbyAddMember - XBOX Game Development Documentation

로컬 사용자를 멤버로 로비에 추가합니다.

구문

HRESULT PFLobbyAddMember(  
    PFLobbyHandle lobby,  
    const PFEntityKey* localUser,  
    uint32_t memberPropertyCount,  
    const char* const* memberPropertyKeys,  
    const char* const* memberPropertyValues,  
    void* asyncContext  
)  

매개 변수

lobby PFLobbyHandle 로비의 핸들입니다. localUser PFEntityKey* 로비에 멤버로 추가할 로컬 사용자의 PlayFab 엔터티 키입니다. memberPropertyCount uint32_t
0,PFLobbyMaxMemberPropertyCount 범위 내 입력 이 사용자가 로비에 참여할 때 설정할 초기 멤버 속성의 수입니다. memberPropertyKeys char* const*
크기가 memberPropertyCount인 입력 배열 이 사용자가 로비에 참여할 때 설정할 초기 멤버 속성의 키입니다. memberPropertyValues char* const*
크기가 memberPropertyCount인 입력 배열 이 사용자가 로비에 참여할 때 설정할 초기 멤버 속성의 값입니다. asyncContext void*
선택 사항 이 호출과 완료 상태 변경을 연결하는 데 사용할 수 있는 선택적인 앱 정의 포인터 크기의 컨텍스트 값입니다.

반환 값

형식: HRESULT 호출이 성공한 경우 S_OK이고, 그렇지 않으면 오류 코드입니다. 오류 코드의 사람이 읽을 수 있는 형태는 PFMultiplayerGetErrorMessage()를 통해 검색할 수 있습니다.

설명

이 작업은 비동기 작업입니다. 성공적으로 완료되면 타이틀에는 PFLobbyMemberAddedStateChange와 PFLobbyAddMemberCompletedStateChange::result 필드가 S_OK로 설정된 PFLobbyAddMemberCompletedStateChange가 순서대로 제공됩니다. 완료에 실패하면 타이틀에는 PFLobbyAddMemberCompletedStateChange::result 필드가 실패 hresult로 설정된 PFLobbyAddMemberCompletedStateChange가 제공됩니다.

이 메서드는 이미 존재하는 로비 개체에 다른 로컬 PlayFab 엔터티를 추가하는 데 사용됩니다. 로비 개체는 PFMultiplayerCreateAndJoinLobby 또는 PFMultiplayerJoinLobby 호출을 통해 이미 만들어져 있어야 하므로, 이 메서드는 주로 여러 로컬 사용자 시나리오에 유용합니다.

이 작업은 비동기 작업입니다. 이 메서드를 통해 추가된 멤버는 비동기 작업이 성공적으로 완료되고 PFMultiplayerStartProcessingLobbyStateChanges에서 PFLobbyMemberAddedStateChange 구조체를 제공할 때까지 PFLobbyGetMembers에서 반환하는 목록에 반영되지 않습니다.

요구 사항

헤더: PFLobby.h

참고 항목

PFLobby 멤버

​구문

​매개 변수

​반환 값

​설명

​요구 사항

​참고 항목

구문

매개 변수

반환 값

설명

요구 사항

참고 항목