PeerCollabDeleteObject 函式 (p2p.h)

PeerCollabDeleteObject 函式會從呼叫端點中刪除對等物件。

語法

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

[in] pObjectId

GUID 值的指標，可唯一識別要從呼叫端點中刪除的對等物件。

如果函式成功，則傳回S_OK。否則，函式會傳回下列其中一個值。

傳回碼	Description
E_OUTOFMEMORY	記憶體不足，無法支援此作業。
E_INVALIDARG	其中一個自變數無效。
PEER_E_NOT_INITIALIZED	Windows 對等基礎結構未初始化。需要呼叫相關的初始化函式。
PEER_E_NOT_SIGNED_IN	作業需要使用者登入。

對等物件是與特定應用程式相關聯的運行時間數據項，例如圖片、虛擬人偶、憑證或特定描述。每個對等物件的大小必須小於 3216K。

監看此對等物件的受信任聯繫人，而「我」聯繫人的訂閱者將會引發PEER_EVENT_OBJECT_CHANGED事件，表示此對等物件的狀態變更。 PEER_EVENT_MY_OBJECT_CHANGED將會在本機引發。

呼叫此 API，無法刪除預先定義的物件，例如 Picture 物件。