Sintaxis
Parámetros
uniqueIdentifier uint16_t*salida El identificador único de salida.
Valor devuelto
PartyErrorc_partyErrorSuccess si la llamada se realizó correctamente o un código de error en caso contrario. La forma legible del código de error se puede recuperar mediante PartyManager::GetErrorMessage().
Comentarios
Este identificador es único dentro de la red del punto de conexión y es coherente en todos los puntos de conexión de una red. Está pensado para usarse como una opción compacta para que los títulos hagan referencia a puntos de conexión específicos en los búferes de datos de PartyLocalEndpoint::SendMessage() sin mucha sobrecarga de ancho de banda ni la necesidad de negociar identificadores manualmente. Este identificador no es único entre redes.En el caso de los puntos de conexión locales, este método producirá un error hasta que PartyManager::StartProcessingStateChanges() haya proporcionado el cambio de estado PartyEndpointCreatedStateChange. En el caso de los puntos de conexión remotos, este método siempre se ejecutará correctamente.
Todos los dispositivos de una red coincidirán en el identificador único de un punto de conexión determinado, pero es posible que distintos dispositivos no vean los mismos puntos de conexión en un momento dado. Por ejemplo, es posible que el punto de conexión A envíe un mensaje al punto de conexión B que haga referencia al identificador único de un punto de conexión C recién creado, pero ese mensaje entre A y B puede llegar antes de que se genere el PartyEndpointCreatedStateChange para el punto de conexión C en el dispositivo del punto de conexión B.
Requisitos
Encabezado: Party.hConsulte también
PartyEndpointPartyEndpointCreatedStateChange
PartyNetwork::FindEndpointByUniqueIdentifier