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

Требования