PFLobbyPostUpdate
플레이어로 로비에 업데이트를 게시합니다.
구문
HRESULT PFLobbyPostUpdate(
PFLobbyHandle lobby,
const PFEntityKey* localUser,
const PFLobbyDataUpdate* lobbyUpdate,
const PFLobbyMemberDataUpdate* memberUpdate,
void* asyncContext
)
매개 변수
lobby PFLobbyHandle
대기실의 핸들.
localUser
PFEntityKey*
업데이트를 게시하는 로컬 사용자입니다.
lobbyUpdate
PFLobbyDataUpdate*
선택 사항
localUser 대신 로비의 공유 부분에 적용할 선택적 업데이트입니다. 이 값이 제공되지 않으면 memberUpdate를 제공해야 합니다.
memberUpdate
PFLobbyMemberDataUpdate*
선택 사항
localUser가 소유한 로비 부분에 적용할 선택적 업데이트입니다 . 이 매개 변수가 제공되지 않으면 lobbyUpdate를 제공해야 합니다.
asyncContext void*
선택 사항
완료 상태 변경을 이 호출과 연결하는 데 사용할 수 있는 선택적 앱 정의 포인터 크기의 컨텍스트 값입니다.
반환 값
형식: HRESULT
호출이 성공한 경우 S_OK이고 그렇지 않은 경우 오류 코드입니다. 사람이 읽을 수 있는 형식의 오류 코드는 PFMultiplayerGetErrorMessage()를 통해 검색할 수 있습니다.
설명
비동기 작업입니다. 성공적으로 완료되면 타이틀에 PFLobbyPostUpdateCompletedStateChange::result 필드가 S_OK로 설정된 PFLobbyPostUpdateCompletedStateChange가 제공됩니다. 완료에 실패하면 타이틀에 PFLobbyPostUpdateCompletedStateChange::result 필드가 실패로 설정된 PFLobbyPostUpdateCompletedStateChange가 제공됩니다. 업데이트 적용 시 로비 상태가 변경되면 나중에 타이틀에 PFLobbyUpdatedStateChange가 제공됩니다.
이 작업의 성공적인 완료는 로비 서비스가 업데이트를 수락했는지 여부만 나타냅니다. 타이틀의 로비 상태 로컬 보기는 PFLobbyUpdatedStateChange가 업데이트된 상태로 타이틀에 제공될 때까지 이 업데이트를 반영하지 않습니다.
lobbyUpdate에는 로비의 소유자만 수정할 수 있는 필드가 포함되어 있습니다. 이 메서드는 해당 필드 중 하나가 지정되고 localUser가 로비의 소유자가 아닌 경우 오류를 반환합니다.
lobbyUpdate및 memberUpdate 가 모두 단일 엔터티를 대신하여 이 메서드에 제공되면 두 업데이트가 모두 전체적으로 진행됩니다.
요구 사항
헤더: PLobby.h