PartyNetwork::GetNetworkDescriptor

이 네트워크의 네트워크 설명자를 가져옵니다.

구문

PartyError GetNetworkDescriptor(  
    PartyNetworkDescriptor* networkDescriptor  
)  

매개 변수

networkDescriptorPartyNetworkDescriptor*
출력

출력 네트워크 설명자입니다.

반환 값

PartyError

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

비고

네트워크 설명자에는 장치를 설명자가 연결된 네트워크에 연결하는 데 필요한 모든 정보가 있습니다. PartyManager::SerializeNetworkDescriptor()를 사용하면 직렬 연결된 형태의 설명자를 가져올 수 있으며, 이 형식의 설명자는 타이틀 및 플랫폼별 통신 채널을 통해 교환하기에 안전합니다. 그러나 이 호출로 제공된 네트워크 설명자는 성공 결과 코드를 포함한 PartyCreateNewNetworkCompletedStateChange라는 신호를 받고 이 네트워크와 연결된 비동기 생성 작업이 성공적으로 완료될 때까지 직렬화할 수 없습니다.

PartyNetworkDescriptors는 원격 사용자에 대한 네트워크 참가 초대가 용이하도록 PartyInvitations와 함께 작동합니다. 먼저 GetNetworkDescriptor()를 통해 네트워크 설명자를 가져오고 PartyManager::SerializeNetworkDescriptor()를 통해 설명자를 직렬로 연결합니다. 다음으로 CreateInvitation()을 통해 초대를 생성하거나 GetInvitations()를 통해 기존 초대를 쿼리하고 PartyInvitation::GetInvitationConfiguration()을 통해 해당 구성에서 초대의 식별자를 가져옵니다. 마지막으로 플랫폼별 초대 메커니즘의 페이로드에 직렬 연결된 네트워크 설명자와 초대 식별자를 모두 포함합니다. 원격 사용자가 초대를 받으면 PartyManager::DeserializeNetworkDescriptor()를 통해 플랫폼 초대 페이로드에서 네트워크 설명자를 분해하고 역직렬화된 설명자를 PartyManager::ConnectToNetwork()로 전달합니다. 연결 후에 원격 사용자는 플랫폼 초대 페이로드에 초대 식별자가 포함된 채로 AuthenticateLocalUser()를 통해 네트워크에 인증하는 식으로 참가합니다.

요구 사항

헤더: Party.h

참고 항목

PartyNetwork
PartyCreateNewNetworkCompletedStateChange
PartyManager::CreateNewNetwork.
PartyManager::SerializeNetworkDescriptor
PartyManager::DeserializeNetworkDescriptor
PartyManager::ConnectToNetwork
PartyInvitation
PartyNetwork::CreateInvitation
PartyNetwork::GetInvitations
PartyInvitation::GetInvitationConfiguration
PartyNetwork::AuthenticateLocalUser