peerCollabSetObject 函式 (p2p.h)

PeerCollabSetObject 函式會建立或更新對等共同作業網路中使用的對等數據物件。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSetObject(
  [in] PCPEER_OBJECT pcObject
);

[in] pcObject

包含對等共同作業網路上對等物件之PEER_OBJECT 結構的指標。

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

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

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

如果對象已發佈， PeerCollabSetObject 將會更新現有的對象數據。更新對象的最後一個應用程式會取得對象的擁有權。因此，如果應用程式終止，則會刪除物件。

如果因為註銷而移除物件的「已發佈」狀態，而不是關閉相關聯的應用程式，應用程式會負責下次使用者登入時發佈物件。

監看此對等物件的受信任聯繫人會在本機引發 PEER_EVENT_OBJECT_CHANGED 事件，表示此對等對象的狀態變更。

PeerCollabSetObject 可用來發佈最多 128 個物件。

有一個物件具有在任何指定時間發佈的指定 GUID 。