PeerCollabSetObject 関数 (p2p.h)

PeerCollabSetObject 関数は、ピアコラボレーションネットワークで使用されるピアデータオブジェクトを作成または更新します。

構文

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSetObject(
  [in] PCPEER_OBJECT pcObject
);

[in] pcObject

ピアコラボレーションネットワーク上のピアオブジェクトを含む PEER_OBJECT 構造体へのポインター。

関数が成功した場合は、S_OKを返します。それ以外の場合、関数は次のいずれかの値を返します。

リターンコード	説明
E_OUTOFMEMORY	この操作をサポートするのに十分なメモリがありません。
E_INVALIDARG	引数の 1 つが無効です。
PEER_E_NOT_INITIALIZED	Windows ピアインフラストラクチャが初期化されていません。関連する初期化関数を呼び出す必要があります。
PEER_E_NOT_SIGNED_IN	この操作では、ユーザーがサインインする必要があります。

ピアオブジェクトは、画像、アバター、証明書、特定の説明など、特定のアプリケーションに関連付けられている実行時データ項目です。各ピアオブジェクトのサイズは 16,000 未満である必要があり、0 にすることはできません。

オブジェクトが既に発行されている場合、 PeerCollabSetObject は既存のオブジェクトデータを更新します。オブジェクトを更新する最後のアプリケーションは、オブジェクトの所有権を取得します。その結果、アプリケーションが終了した場合、オブジェクトは削除されます。

関連付けられたアプリケーションが閉じるのではなく、サインアウトのためにオブジェクトの '発行済み' 状態が削除された場合、アプリケーションは次回ユーザーがサインオンするときのオブジェクトの発行を担当します。

このピアオブジェクトを監視している信頼された連絡先には、ローカルで PEER_EVENT_OBJECT_CHANGED イベントが発生し、このピアオブジェクトの状態の変化が通知されます。

PeerCollabSetObject を 使用して、最大 128 個のオブジェクトを発行できます。

特定の GUID を持つ 1 つのオブジェクトが、いつでも公開されます。