Функция 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 , чтобы продолжить перечисление. В противном случае он должен вернуть один из следующих кодов ошибок.

Комментарии

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

Требования