peerGroupSearchRecords 函式 (p2p.h)
PeerGroupSearchRecords 函式會搜尋本機對等群組資料庫,尋找符合所提供準則的記錄。
語法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupSearchRecords(
[in] HGROUP hGroup,
[in] PCWSTR pwzCriteria,
[out] HPEERENUM *phPeerEnum
);
參數
[in] hGroup
處理至搜尋其本機資料庫的對等群組。 這個控制碼是由PeerGroupCreate、PeerGroupOpen或PeerGroupJoin函式傳回。 此為必要參數。
[in] pwzCriteria
包含記錄搜尋查詢之 Unicode XML 字串的指標。 如需有關建立 XML 查詢字串來搜尋對等群組記錄資料庫的資訊,請參閱 記錄搜尋查詢格式 檔。 此為必要參數。
[out] phPeerEnum
列舉的指標,其中包含傳回的記錄清單。 此控制碼會傳遞至
PeerGetNextItem ,擷取專案,每個專案都表示為 PEER_RECORD 結構的指標。 完成時, 會呼叫 PeerEndEnumeration 以傳回列舉所使用的記憶體。 此為必要參數。
傳回值
如果作業成功,則傳回 S_OK 。 否則,函式會傳回下列其中一個值。
傳回碼 | 描述 |
---|---|
|
其中一個參數無效。 |
|
記憶體不足,無法完成作業。 |
|
XML 搜尋查詢不符合 搜尋查詢架構規格。 |
密碼編譯特定錯誤可以從 Microsoft RSA 基底提供者傳回。 這些錯誤前面會加上 CRYPT_* 並在 Winerror.h 中定義。
需求
最低支援的用戶端 | Windows XP 搭配 SP2 [僅限傳統型應用程式],Windows XP 含 SP1 與 Windows XP 的進階網路套件 |
最低支援的伺服器 | 都不支援 |
目標平台 | Windows |
標頭 | p2p.h |
程式庫 | P2P.lib |
Dll | P2P.dll |