Функция PeerGetNextItem (p2p.h)

Статья
03/05/2024

Функция PeerGetNextItem возвращает определенное количество элементов из однорангового перечисления.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGetNextItem(
  [in]      HPEERENUM hPeerEnum,
  [in, out] ULONG     *pCount,
  [out]     PVOID     **pppvItems
);

Параметры

[in] hPeerEnum

Дескриптор однорангового перечисления, из которого извлекаются элементы. Этот дескриптор создается функцией однорангового перечисления.

[in, out] pCount

Указатель на целое число, указывающее количество элементов, извлекаемых из однорангового перечисления. При возвращении он содержит количество элементов в ppvItems. Этот параметр не может иметь значение NULL.

[out] pppvItems

Получает указатель на массив указателей на следующие элементы pCount в одноранговом перечислении. Данные, например блок сведений о записях или членах, зависят от фактического типа перечисления одноранговых узлов.

Возвращаемое значение

Возвращает S_OK , если операция выполнена успешно. В противном случае функция возвращает одно из следующих значений.

Код возврата	Описание
E_INVALIDARG	Один из параметров недопустим.
E_OUTOFMEMORY	Недостаточно памяти для выполнения указанной операции.

Элементы, которые равны или меньше суммы, указанной в pCount.
Список элементов, которые меньше указанного количества, если сумма превышает количество доступных элементов.

Примечание Например, если входящее значение pCount равно 10, а остальная часть перечисления составляет 5 элементов, возвращается только 5 элементов, а значение, на которое указывает pCount , равно 5.

Все возвращаемые элементы должны быть освобождены путем передачи указателя на массив указателей на функцию PeerFreeData .

Конец перечисления указывается, когда функция возвращает значение с параметром pCount , равным нулю (0).

Требования

Требование	Значение
Минимальная версия клиента	Windows XP с пакетом обновления 2 (SP2) [только классические приложения], Windows XP с пакетом обновления 1 (SP1) с дополнительным сетевым пакетом для Windows XP
Минимальная версия сервера	Ни одна версия не поддерживается
Целевая платформа	Windows
Header	p2p.h
Библиотека	P2P.lib
DLL	P2P.dll