PeerGraphDeleteRecord 函式 (p2p.h)

  • 發行項

PeerGraphDeleteRecord 函式會將記錄標示為在對等圖形內刪除。 本機節點上無法使用記錄來函式呼叫，例如對PeerGraphGetRecord和PeerGraphEnumRecords的呼叫。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphDeleteRecord(
  [in] HGRAPH     hGraph,
  [in] const GUID *pRecordId,
  [in] BOOL       fLocal
);

參數

[in] hGraph

對等圖形的句柄。

[in] pRecordId

要刪除的記錄標識碼指標。

[in] fLocal

指定 TRUE ，只從本機資料庫移除記錄，而不會通知對等圖形的其餘部分變更。 指定 FALSE 以從整個對等圖形刪除記錄。

注意 指定 TRUE 不會防止在與鄰近的下一個圖形同步處理期間再次新增記錄。 只有在對 PeerGraphOpen 或 PeerGraphCreate 的呼叫中指定PEER_SECURITY_INTERFACE，而且只有在PEER_SECURITY_INTERFACE包含驗證記錄時傳回PEER_E_INVALID_RECORD的PFNPEER_VALIDATE_RECORD函式時，才有效。
 

傳回值

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

傳回碼 Description
E_ACCESSDENIED
 無法存取對等圖形。
PEER_E_GRAPH_NOT_READY
 對等圖形未同步處理。 在同步處理圖表之前，無法刪除記錄。
PEER_E_INVALID_GRAPH
 對等圖形的句柄無效。
PEER_E_NOT_INITIALIZED
 使用這個函式之前，必須先呼叫 PeerGraphStartup 來初始化對等圖形。
PEER_E_RECORD_NOT_FOUND
 找不到指定的記錄。

規格需求

需求 值
最低支援的用戶端 Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 搭配 SP1 與適用於Windows XP 的進階網络套件
最低支援的伺服器 都不支援
目標平台 Windows
標頭 p2p.h
程式庫 P2PGraph.lib
Dll P2PGraph.dll

另請參閱

PeerGraphAddRecord

PeerGraphEnumRecords

PeerGraphGetRecord

PeerGraphUpdateRecord