このエンドポイントのネットワーク固有の識別子を取得します。
構文
PartyError GetUniqueIdentifier(
uint16_t* uniqueIdentifier
)
パラメーター
uniqueIdentifier uint16_t*
output
出力の一意の識別子。
戻り値
PartyError
呼び出しが成功した場合は c_partyErrorSuccess、それ以外の場合はエラー コードになります。 人間が読める形式のエラー コードは、PartyManager::GetErrorMessage() を介して取得できます。
解説
この識別子は、エンドポイントのネットワーク内で一意であり、ネットワーク内のすべてのエンドポイントで一貫性があります。 これは、タイトルが PartyLocalEndpoint::SendMessage() データ バッファー内の特定のエンドポイントを参照するためのコンパクト なオプションとして使用することを目的としています。帯域幅のオーバーヘッドや識別子を手動でネゴシエートする必要はありません。 この識別子は、ネットワーク間で一意ではありません。
ローカル エンドポイントの場合、このメソッドは、 PartyEndpointCreatedStateChange が PartyManager::StartProcessingStateChanges() によって提供されるまで失敗します。 リモート エンドポイントの場合、このメソッドは常に成功します。
ネットワーク内のすべてのデバイスは、特定のエンドポイントの一意な識別子に同意しますが、特定の時点で異なるデバイスに同じエンドポイントが表示されない場合があります。 たとえば、エンドポイント A は、新しく作成されたエンドポイント C の一意の識別子を参照するメッセージをエンドポイント B に送信できますが、エンドポイント C の PartyEndpointCreatedStateChange がエンドポイント B のデバイスで生成される前に、A と B の間のメッセージが到着する可能性があります。
要件
ヘッダー: Party.h
関連項目
PartyEndpoint
PartyEndpointCreatedStateChange
PartyNetwork::FindEndpointByUniqueIdentifier