Функция FilterVolumeInstanceFindNext (fltuser.h)

Статья
08/23/2023

Функция FilterVolumeInstanceFindNext продолжает поиск экземпляра драйвера минифильтра или устаревшего фильтра, запущенного вызовом FilterVolumeInstanceFindFird.

Синтаксис

HRESULT FilterVolumeInstanceFindNext(
  [in]  HANDLE                     hVolumeInstanceFind,
  [in]  INSTANCE_INFORMATION_CLASS dwInformationClass,
  [out] LPVOID                     lpBuffer,
  [in]  DWORD                      dwBufferSize,
  [out] LPDWORD                    lpBytesReturned
);

Параметры

[in] hVolumeInstanceFind

Дескриптор поиска драйвера фильтра томов, возвращенный предыдущим вызовом FilterVolumeInstanceFindFirst.

[in] dwInformationClass

Тип возвращаемой структуры сведений о драйвере фильтра. Этот параметр должен содержать одно из следующих значений.

Значение	Значение
InstanceBasicInformation	Возвращает структуру INSTANCE_BASIC_INFORMATION для экземпляра минифильтра. Устаревшие драйверы фильтров игнорируются.
InstanceFullInformation	Возвращает структуру INSTANCE_FULL_INFORMATION для экземпляра минифильтра. Устаревшие драйверы фильтров игнорируются.
InstancePartialInformation	Возвращает структуру INSTANCE_PARTIAL_INFORMATION для экземпляра минифильтра. Устаревшие драйверы фильтров игнорируются.
InstanceAggregateStandardInformation	Возвращает структуру INSTANCE_AGGREGATE_STANDARD_INFORMATION для экземпляра . Элемент LegacyFilter структуры не используется. Эта структура доступна начиная с Windows Vista.

[out] lpBuffer

Указатель на буфер, выделенный вызывающим объектом, который получает запрошенные сведения. Тип сведений, возвращаемых в буфере, определяется параметром dwInformationClass .

[in] dwBufferSize

Размер (в байтах) буфера, на который указывает параметр lpBuffer . Вызывающий объект должен задать этот параметр в соответствии с заданным dwInformationClass.

[out] lpBytesReturned

Указатель на переменную, выделенную вызывающим объектом, которая получает количество байтов, возвращаемых в буфере, на которое указывает lpBuffer , если вызов FilterVolumeInstanceFindNext завершается успешно. Этот параметр является обязательным и не может иметь значение NULL.

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

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

Код возврата	Описание
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	Буфер, на который указывает lpBuffer , недостаточно велик, чтобы содержать запрошенные сведения. При возвращении этого значения lpBytesReturned будет содержать размер буфера, необходимого для данной структуры dwInformationClass , в байтах.
HRESULT_FROM_WIN32(ERROR_INVALID_PARAMETER)	Для параметра dwInformationClass указано недопустимое значение. Например, если параметр InstanceAggregateStandardInformation указан для операционной системы, предшествующей Windows Vista, функция FilterVolumeInstanceFindNext возвращает это значение HRESULT.
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)	На данном томе больше не найдены драйверы фильтров.

После установки дескриптора поиска путем вызова FilterVolumeInstanceFindFirst используйте функцию FilterVolumeInstanceFindNext для поиска других драйверов фильтров, присоединенных к тому, указанному в вызове FilterVolumeInstanceFindFirst. Если дескриптор поиска больше не требуется, закройте его, вызвав FilterVolumeInstanceFindClose.

Начиная с Windows Vista, эта подпрограмма может возвращать как сведения о драйвере устаревшего фильтра, так и сведения об экземпляре драйвера минифильтра, если параметр dwInformationClass имеет значение InstanceAggregateStandardInformation. Для более ранних операционных систем эта подпрограмма не может возвращать устаревшие сведения о фильтре, так как структура INSTANCE_AGGREGATE_STANDARD_INFORMATION недоступна.

Требования

Требование	Значение
Целевая платформа	Универсальное
Верхняя часть	fltuser.h (включая FltUser.h)
Библиотека	FltLib.lib
DLL	FltLib.dll