PartyNetwork::FindEndpointByUniqueIdentifier

이 네트워크에 해당 네트워크 고유 식별자가 있는 엔드포인트(있는 경우)를 찾습니다.

구문

PartyError FindEndpointByUniqueIdentifier(  
    uint16_t uniqueIdentifier,  
    PartyEndpoint** endpoint  
)  

매개 변수

uniqueIdentifier uint16_t

엔드포인트의 네트워크 고유 식별자입니다.

endpointPartyEndpoint**
라이브러리 할당 출력

네트워크 고유 식별자가 uniqueIdentifier와 일치하는 출력 엔드포인트입니다.

반환 값

PartyError

c_partyErrorSuccess식별자가 일치하는 엔드포인트가 이 네트워크에서 발견되었거나 혹은 오류 코드입니다. 사용자가 읽을 수 있는 형식의 오류 코드는 PartyManager::GetErrorMessage()를 통해 검색할 수 있습니다.

비고

이 메서드는 로컬 장치에서 엔드포인트가 유효하지 않으면 오류를 반환합니다. 즉, PartyManager::StartProcessingStateChanges()에서 uniqueIdentifier와 연결된 엔드포인트에 대한 PartyEndpointCreatedStateChange를 아직 제공하지 않은 경우 또는 PartyEndpointDestroyedStateChange가 생성되었으며 엔드포인트를 참조하는 모든 상태 변경 내용이 PartyManager::FinishProcessingStateChanges()로 반환된 경우입니다.

네트워크의 모든 장치는 지정된 엔드포인트의 고유 식별자에 동의하지만, 특정 시점에 다른 장치에서 동일한 엔드포인트를 볼 수 없습니다. 예를 들어 엔드포인트 A가 새로 만든 엔드포인트 C의 고유 식별자를 참조하는 메시지를 엔드포인트 B에 보낼 수 있지만 엔드포인트 C에 대한 PartyEndpointCreatedStateChange가 엔드포인트 B의 장치에서 생성되기 전에 A와 B 사이의 메시지가 도착할 수 있습니다. 이러한 경우 엔드포인트 C가 해당 장치에서 아직 알려지지 않았기 때문에 이 메서드는 엔드포인트 B의 장치에서 호출될 때 오류를 반환합니다.

요구 사항

헤더: Party.h

참고 항목

PartyNetwork
PartyEndpoint::GetUniqueIdentifier
PartyEndpointCreatedStateChange
PartyEndpointDestroyedStateChange