Skip to main content
获取此终结点的网络中唯一的标识符。

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.h

See also

PartyEndpoint
PartyEndpointCreatedStateChange
PartyNetwork::FindEndpointByUniqueIdentifier
最后修改于 2026年8月13日