Syntaxe
Paramètres
uniqueIdentifier uint16_t*output L’identificateur unique de sortie.
Valeur de retour
PartyErrorc_partyErrorSuccess si l’appel a réussi; sinon, un code d’erreur. La forme lisible du code d’erreur peut être obtenue au moyen de PartyManager::GetErrorMessage().
Remarques
Cet identificateur est unique au sein du réseau du point de terminaison et est cohérent pour tous les points de terminaison d’un réseau. Il est destiné à être utilisé comme une option compacte permettant aux titres de faire référence à des points de terminaison spécifiques dans les mémoires tampons de données de PartyLocalEndpoint::SendMessage(), sans surcharge de bande passante importante ni besoin de négocier manuellement des identificateurs. Cet identificateur n’est pas unique d’un réseau à l’autre.Pour les points de terminaison locaux, cette méthode échoue tant que le PartyEndpointCreatedStateChange n’a pas été fourni par PartyManager::StartProcessingStateChanges(). Pour les points de terminaison distants, cette méthode réussit toujours.
Tous les appareils d’un réseau s’accordent sur l’identificateur unique d’un point de terminaison donné, mais différents appareils peuvent ne pas voir les mêmes points de terminaison à un moment donné. Par exemple, il est possible que le point de terminaison A envoie au point de terminaison B un message faisant référence à l’identificateur unique d’un point de terminaison C nouvellement créé, mais que ce message entre A et B arrive avant que le PartyEndpointCreatedStateChange du point de terminaison C soit généré sur l’appareil du point de terminaison B.
Configuration requise
En-tête : Party.hVoir aussi
PartyEndpointPartyEndpointCreatedStateChange
PartyNetwork::FindEndpointByUniqueIdentifier