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