PeerCollabDeleteObject 関数 (p2p.h)

PeerCollabDeleteObject 関数は、呼び出し元のエンドポイントからピアオブジェクトを削除します。

構文

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabDeleteObject(
  [in] const GUID *pObjectId
);

[in] pObjectId

呼び出し元のエンドポイントから削除するピアオブジェクトを一意に識別する GUID 値へのポインター。

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

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

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

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

Picture オブジェクトなどの定義済みオブジェクトは、この API を呼び出して削除することはできません。