Функция PeerGraphEnumRecords (p2p.h)
Функция PeerGraphEnumRecords создает и возвращает дескриптор перечисления, используемый для перечисления записей определенного типа записи, пользователя или и того, и другого. Перечисление предоставляет snapshot записей во время выполнения перечисления.
Синтаксис
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphEnumRecords(
[in] HGRAPH hGraph,
[in] const GUID *pRecordType,
[in] PCWSTR pwzPeerId,
[out] HPEERENUM *phPeerEnum
);
Параметры
[in] hGraph
Дескриптор однорангового графа.
[in] pRecordType
Указатель на тип записей для перечисления. Укажите значение NULL для перечисления всех типов записей.
[in] pwzPeerId
Указатель на строку, идентифицирующая создателя, для которому приложение запрашивает перечисление. Укажите значение NULL для перечисления всех записей.
[out] phPeerEnum
Получает дескриптор перечисления. Укажите дескриптор для всех вызовов PeerGraphGetNextItem. Если дескриптор не требуется, освободите его, вызвав PeerGraphEndEnumeration.
Возвращаемое значение
Если вызов функции выполнен успешно, возвращаемое значение будет S_OK. В противном случае возвращается одно из следующих значений.
Код возврата | Описание |
---|---|
|
Один параметр недопустим. |
|
Недостаточно памяти для выполнения указанной операции. |
|
Дескриптор однорангового графа недопустим. |
|
Граф необходимо инициализировать с помощью вызова PeerGraphStartup перед использованием этой функции. |
Комментарии
- Если параметры pRecordType и pwzPeerId имеют значение NULL, возвращаются все записи.
- Для простых задач перечисления используйте функцию PeerGraphEnumRecords , так как она более эффективна, чем функция PeerGraphSearchRecords . Для сложных задач перечисления и фильтрации, таких как эвристические поиски в базе данных, используйте функцию PeerGraphSearchRecords .
- При вызове PeerGraphGetNextItem с дескриптором, который возвращает PeerGraphEnumRecords , PeerGraphGetNextItem возвращает данные в структуре PEER_RECORD .
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows XP с пакетом обновления 2 (SP2) [только классические приложения], Windows XP с пакетом обновления 1 (SP1) с дополнительным сетевым пакетом для Windows XP |
Минимальная версия сервера | Ни одна версия не поддерживается |
Целевая платформа | Windows |
Header | p2p.h |
Библиотека | P2PGraph.lib |
DLL | P2PGraph.dll |