Функция FindFirstFileExFromAppW (fileapifromapp.h)

Статья
08/23/2023

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

Синтаксис

WINSTORAGEAPI HANDLE FindFirstFileExFromAppW(
  LPCWSTR            lpFileName,
  FINDEX_INFO_LEVELS fInfoLevelId,
  LPVOID             lpFindFileData,
  FINDEX_SEARCH_OPS  fSearchOp,
  LPVOID             lpSearchFilter,
  DWORD              dwAdditionalFlags
) noexcept;

Параметры

lpFileName

Каталог или путь, а также имя файла. Имя файла может содержать подстановочные знаки, например звездочку (*) или вопросительный знак (?).

Этот параметр не должен иметь значение NULL, недопустимую строку (например, пустую строку или строку, в которую отсутствует завершающий символ NULL) или заканчиваться обратной косой чертой (\).

Если строка заканчивается подстановочным знаком, точкой или именем каталога, пользователь должен иметь доступ к корневому каталогу и всем подкаталогам по пути.

Сведения об отказе от ограничения MAX_PATH без добавления в начало "\\?\" см. в разделе "Ограничение максимальной длины пути" статьи Именование файлов, путей и пространств имен .

fInfoLevelId

Уровень сведений возвращаемых данных.

Этот параметр является одним из FINDEX_INFO_LEVELS значений перечисления.

lpFindFileData

Указатель на буфер, который получает данные файла.

Тип указателя определяется уровнем сведений, указанным в параметре fInfoLevelId .

fSearchOp

Тип выполняемой фильтрации, отличающийся от сопоставления с подстановочными знаками.

Этот параметр является одним из FINDEX_SEARCH_OPS значений перечисления.

lpSearchFilter

Указатель на критерии поиска, если для указанного fSearchOp требуются структурированные поисковые сведения.

В настоящее время ни одно из поддерживаемых значений fSearchOp не требует расширенных сведений о поиске. Поэтому этот указатель должен иметь значение NULL.

dwAdditionalFlags

Задает дополнительные флаги, управляющие поиском.

Значение	Значение
FIND_FIRST_EX_CASE_SENSITIVE 1	При поиске учитывается регистр.
FIND_FIRST_EX_LARGE_FETCH 2	Использует буфер большего размера для запросов каталога, что может повысить производительность операции поиска.
FIND_FIRST_EX_ON_DISK_ENTRIES_ONLY 4	Ограничивает результаты файлами, которые физически находятся на диске. Этот флаг применяется только при наличии фильтра виртуализации файлов.

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

Если функция выполняется успешно, возвращаемое значение представляет собой дескриптор поиска, используемый при последующем вызове FindNextFile или FindClose, а параметр lpFindFileData содержит сведения о первом найденном файле или каталоге.

Если функции не удается найти файлы из строки поиска в параметре lpFileName , возвращаемое значение будет INVALID_HANDLE_VALUE а содержимое lpFindFileData не определено. Чтобы получить расширенные сведения об ошибке, вызовите функцию GetLastError .

Требования

Требование	Значение
Минимальная версия клиента	Windows 10 версии 1803
Верхняя часть	fileapifromapp.h

Поделиться через