peerGroupEnumRecords 函式 (p2p.h)
PeerGroupEnumRecords 函式會建立對等群組記錄的列舉。
語法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupEnumRecords(
[in] HGROUP hGroup,
[in] const GUID *pRecordType,
[out] HPEERENUM *phPeerEnum
);
參數
[in] hGroup
控制碼至列舉其記錄的對等群組。 這個控制碼是由PeerGroupCreate、PeerGroupOpen或PeerGroupJoin函式傳回。 此為必要參數。
[in] pRecordType
可唯一識別特定記錄類型的 GUID 值指標。 如果此參數為 Null,則會傳回所有記錄。
[out] phPeerEnum
列舉的指標,其中包含傳回的記錄清單。 此控制碼會傳遞至
PeerGetNextItem 以擷取專案,每個專案都表示為 PEER_RECORD 結構的指標。 完成時, 會呼叫 PeerEndEnumeration 以傳回列舉所使用的記憶體。 此為必要參數。
傳回值
如果作業成功,則傳回 S_OK 。 否則,函式會傳回下列其中一個值。
傳回碼 | 描述 |
---|---|
|
其中一個參數無效。 |
|
記憶體不足,無法執行指定的作業。 |
|
對等群組的控制碼無效。 |
密碼編譯特定錯誤可以從 Microsoft RSA 基底提供者傳回。 這些錯誤前面會加上 CRYPT_* 並在 Winerror.h 中定義。
需求
最低支援的用戶端 | Windows XP 搭配 SP2 [僅限傳統型應用程式],Windows XP 含 SP1 與 Windows XP 的進階網路套件 |
最低支援的伺服器 | 都不支援 |
目標平台 | Windows |
標頭 | p2p.h |
程式庫 | P2P.lib |
Dll | P2P.dll |