Функция NPEnumResource (npapi.h)

  • Статья

Выполняет перечисление на основе дескриптора, возвращаемого NPOpenEnum.

Синтаксис

DWORD NPEnumResource(
  [in]      HANDLE  hEnum,
  [in, out] LPDWORD lpcCount,
  [out]     LPVOID  lpBuffer,
  [in, out] LPDWORD lpBufferSize
);

Параметры

[in] hEnum

Дескриптор, полученный из вызова NPOpenEnum .

[in, out] lpcCount

Указатель на количество запрошенных записей. Возможно, 0xFFFFFFFF запрашивать как можно больше записей. Если вызов будет выполнен успешно, это расположение получит количество фактически прочитанных записей.

[out] lpBuffer

Указатель на буфер для получения результата перечисления, который возвращается в виде массива записей NETRESOURCE . Буфер действителен до следующего вызова с помощью hEnum.

[in, out] lpBufferSize

Указатель на размер (в байтах) буфера, передаваемого в вызов функции при входе. Если буфер слишком мал для одной записи, он должен содержать при выходе количество байтов, необходимых для чтения одной записи. Это значение задается, только если код возврата WN_MORE_DATA.

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

Если функция завершается успешно, она должна вернуть WN_SUCCESS. Вызывающий объект может продолжать вызывать NPEnumResource , чтобы продолжить перечисление. В противном случае он должен вернуть один из следующих кодов ошибок.

Код возврата Описание
WN_NO_MORE_ENTRIES
 Больше нет записей. Перечисление выполнено успешно. В этом случае содержимое возвращаемого буфера lpBuffer не определено.
WN_MORE_DATA
 Буфер слишком мал, чтобы вместить даже одну запись.
WN_BAD_HANDLE
 hEnum не является допустимым дескриптором.
WN_NO_NETWORK
 Сеть отсутствует. Это условие проверяется перед проверкой hEnum на допустимость.

Комментарии

При вызове этой функции поставщик должен заполнить буфер запрошенным количеством записей (или максимальным значением, которое может поместиться). Возвращаемые структуры NETRESOURCE должны располагаться в начале буфера, как массив таких структур. Указатели в этих структурах должны указывать на расположения в буфере. Поэтому данные, на которые ссылаются эти указатели, должны находиться в конце буфера после массива структур. Поставщик несет ответственность за правильную упаковку этих сведений.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header npapi.h