peerGraphGetRecord 函式 (p2p.h)

  • 發行項

PeerGraphGetRecord 函式會根據指定的記錄標識符擷取特定記錄。 傳回的記錄應該藉由呼叫 PeerGraphFreeData 來釋放。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphGetRecord(
  [in]  HGRAPH       hGraph,
  [in]  const GUID   *pRecordId,
  [out] PPEER_RECORD *ppRecord
);

參數

[in] hGraph

對等圖形的句柄。

[in] pRecordId

要擷取之記錄標識碼的指標。

[out] ppRecord

接收要求的記錄。 當不再需要這個結構時，請呼叫 PeerGraphFreeData 來釋放它。

傳回值

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

傳回碼 Description
E_INVALIDARG
 其中一個參數無效。
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

另請參閱

PEER_RECORD

PeerGraphFreeData