Syntax
Parameters
uniqueIdentifier uint16_t*output 输出的唯一标识符。
Return value
PartyError 如果调用成功,则返回c_partyErrorSuccess;否则返回错误代码。可通过 PartyManager::GetErrorMessage() 检索错误代码的可读形式。
Remarks
此标识符在终结点的网络内是唯一的,并且在网络中的所有终结点之间保持一致。它旨在为标题提供一个紧凑的选项,在 PartyLocalEndpoint::SendMessage() 数据缓冲区中引用特定终结点时不需要太多带宽开销,也无需手动协商标识符。此标识符在跨网络时不唯一。对于本地终结点,在 PartyManager::StartProcessingStateChanges() 提供了 PartyEndpointCreatedStateChange 之前,此方法将失败。对于远程终结点,此方法始终会成功。
网络中的所有设备都会就某个终结点的唯一标识符达成一致,但不同设备可能不会在同一时刻看到相同的终结点。例如,终结点 A 可能会向终结点 B 发送一条引用新创建终结点 C 的唯一标识符的消息,但 A 与 B 之间的这条消息可能会在终结点 B 的设备上为终结点 C 生成 PartyEndpointCreatedStateChange 之前到达。
Requirements
Header: Party.hSee also
PartyEndpointPartyEndpointCreatedStateChange
PartyNetwork::FindEndpointByUniqueIdentifier
