peerGraphSearchRecords 函式 (p2p.h)

PeerGraphSearchRecords 函式會搜尋對等圖表中的特定記錄。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphSearchRecords(
  [in]  HGRAPH    hGraph,
  [in]  PCWSTR    pwzCriteria,
  [out] HPEERENUM *phPeerEnum
);

[in] hGraph

對等圖形的句柄。

[in] pwzCriteria

XML 字串的指標，指定要搜尋的記錄。如需有關制訂 XML 查詢字串以搜尋對等圖形記錄的資訊，請參閱記錄搜尋查詢格式。

[out] phPeerEnum

列舉的句柄。

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

傳回碼	Description
E_INVALIDARG	其中一個參數無效。
E_OUTOFMEMORY	記憶體不足，無法執行指定的作業。
PEER_E_INVALID_GRAPH	對等圖形的句柄無效。
PEER_E_INVALID_SEARCH	指定的查詢不符合搜尋架構。如需詳細資訊，請參閱記錄搜尋查詢格式。
PEER_E_NOT_INITIALIZED	使用這個函式之前，必須先使用對PeerGraphStartup 的呼叫來初始化對等圖形。

PeerGraphEnumRecords 函式比 PeerGraphSearchRecords 函式更有效率。

使用 PeerGraphSearchRecords 所傳回的句柄呼叫 PeerGraphGetNextItem 時，PeerGraphGetNextItem 會傳回PEER_RECORD結構中的數據。

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