Функция FilterVolumeFindNext (fltuser.h)
Функция FilterVolumeFindNext продолжает поиск тома, запущенный вызовом FilterVolumeFindFirst.
Синтаксис
HRESULT FilterVolumeFindNext(
[in] HANDLE hVolumeFind,
[in] FILTER_VOLUME_INFORMATION_CLASS dwInformationClass,
[out] LPVOID lpBuffer,
[in] DWORD dwBufferSize,
[out] LPDWORD lpBytesReturned
);
Параметры
[in] hVolumeFind
Дескриптор поиска тома, возвращенный предыдущим вызовом FilterVolumeFindFirst.
[in] dwInformationClass
Тип запрашиваемой информации. Этот параметр может принимать одно из указанных ниже значений.
| Значение | Значение |
|---|---|
| FilterVolumeBasicInformation | Буфер, на который указывает параметр lpBuffer , получает FILTER_VOLUME_BASIC_INFORMATION структуру для тома. |
| FilterVolumeStandardInformation | Буфер, на который указывает параметр lpBuffer , получает FILTER_VOLUME_STANDARD_INFORMATION структуру для тома. Эта структура доступна начиная с Windows Vista. |
[out] lpBuffer
Указатель на буфер, выделенный вызывающим объектом, который получает запрошенные сведения. Тип информации, возвращаемой в буфере, определяется параметром dwInformationClass .
[in] dwBufferSize
Размер (в байтах) буфера, на который указывает параметр lpBuffer . Вызывающий объект должен задать этот параметр в соответствии с заданным dwInformationClass.
[out] lpBytesReturned
Указатель на переменную, выделенную вызывающим объектом, которая получает количество байтов, возвращаемых в буфере, на которое указывает lpBuffer при успешном вызове FilterVolumeFindNext . Этот параметр является обязательным и не может иметь значение NULL.
Возвращаемое значение
FilterVolumeFindNext возвращает S_OK, если он успешно возвращает сведения о томе. В противном случае возвращается значение ошибки HRESULT, например одно из следующих значений:
| Код возврата | Описание |
|---|---|
|
Буфер, на который указывает lpBuffer, недостаточно велик, чтобы содержать запрошенные сведения. При возврате этого значения lpBytesReturned будет содержать размер буфера, необходимого для данной структуры dwInformationClass (в байтах). |
|
Для параметра dwInformationClass указано недопустимое значение. Например, если параметр FilterVolumeStandardInformation указан для операционной системы, предшествующей Windows Vista, функция FilterVolumeFindNext возвращает это значение HRESULT. |
|
В списке томов, известных диспетчеру фильтров, больше не найдено томов. |
Комментарии
После установки дескриптора поиска путем вызова FilterVolumeFindFirst используйте функцию FilterVolumeFindNext для поиска других томов. FilterVolumeFindNext находит один том для каждого вызова.
Обратите внимание, что при использовании FilterVolumeFindFirst и FilterVolumeFindNext для перечисления списка томов, известных диспетчеру фильтров, два или более тома в списке могут иметь одинаковое имя. Дополнительные сведения см. в разделе Основные сведения о перечислениях томов с повторяющимися именами томов.
Требования
| Целевая платформа | Универсальное |
| Верхняя часть | fltuser.h (включая FltUser.h) |
| Библиотека | FltLib.lib |
| DLL | FltLib.dll |
См. также раздел
FILTER_VOLUME_BASIC_INFORMATION