PFLobbyForceRemoveMember
대기실에서 엔티티를 강제로 제거합니다.
구문
HRESULT PFLobbyForceRemoveMember(
PFLobbyHandle lobby,
const PFEntityKey* targetMember,
bool preventRejoin,
void* asyncContext
)
매개 변수
lobby PFLobbyHandle
대기실의 핸들.
targetMember
PFEntityKey*
강제로 제거할 구성원입니다.
preventRejoin부울
targetMember이(가) 제거된 후 대기실에 다시 참가할 수 없는지 여부를 나타내는 플래그입니다.
asyncContext void*
선택 사항
완료 상태 변경을 이 호출과 연결하는 데 사용할 수 있는 선택적 앱 정의 포인터 크기의 컨텍스트 값입니다.
반환 값
형식: HRESULT
호출이 성공한 경우 S_OK이고 그렇지 않은 경우 오류 코드입니다. 사람이 읽을 수 있는 형식의 오류 코드는 PFMultiplayerGetErrorMessage()를 통해 검색할 수 있습니다.
설명
비동기 작업입니다. 성공적으로 완료되면 타이틀에 PFLobbyMemberRemovedStateChange와 함께 PFLobbyForceRemoveMemberCompletedStateChange가 제공되고 PFLobbyForceRemoveMemberCompletedStateChange::result 필드가 S_OK에 설정됩니다. 완료에 실패하면 타이틀에 PFLobbyForceRemoveMemberCompletedStateChange가 제공되고 PFLobbyForceRemoveMemberCompletedStateChange::result 필드가 실패 hresult로 설정됩니다.
이 작업이 성공하려면 이 로비에 있는 로컬 PlayFab 엔터티 중 하나가 소유자여야 합니다. 작업이 진행되는 동안 이 작업을 시작한 로컬 소유 엔터티가 소유권 상태를 잃으면 작업이 비동기적으로 실패합니다.
비동기 작업입니다. 이 메서드를 통해 제거된 멤버는 비동기 작업이 성공적으로 완료되고 PFMultiplayerStartProcessingLobbyStateChanges에서 PFLobbyMemberRemovedStateChange 구조체를 제공하기 전까지는 PFLobbyGetMembers에서 반환한 목록에서 제거되지 않습니다.
요구 사항
헤더: PLobby.h