다음을 통해 공유


PFLobbyGetSearchProperty

키에서 검색 속성 값을 가져옵니다.

구문

HRESULT PFLobbyGetSearchProperty(  
    PFLobbyHandle lobby,  
    const char* key,  
    const char** value  
)  

매개 변수

lobby PFLobbyHandle

로비의 손잡이.

key char*
is null-terminated

속성의 키입니다.

value자**
라이브러리에서 할당한 출력, nullptr을 반환할 수 있음

키와 관련된 출력 값입니다. 출력 null 값은 속성이 없음을 나타냅니다.

반환 값

형식: HRESULT

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

설명

검색 속성은 로비 검색 결과를 필터링하고 정렬하는 데 사용할 수 있는 메타데이터로 로비의 비멤버에게 표시됩니다.

이 로비 개체가 여전히 PFMultiplayerCreateAndJoinLobby(), PFMultiplayerCreateAndClaimServerLobby, PFMultiplayerClaimServerLobby() 또는 PFMultiplayerJoinLobby() 호출을 통해 비동기적으로 생성, 결합 또는 클레임되는 중인 경우 이 메서드는 속성을 반환하지 않습니다.

요구 사항

헤더: PLobby.h

참고 항목

PFLobby 멤버