Функция FltIsDirectory (fltkernel.h)

Статья
08/07/2023

Драйвер минифильтра вызывает подпрограмму FltIsDirectory , чтобы определить, представляет ли данный объект файла каталог.

Синтаксис

NTSTATUS FLTAPI FltIsDirectory(
  [in]  PFILE_OBJECT  FileObject,
  [in]  PFLT_INSTANCE Instance,
  [out] PBOOLEAN      IsDirectory
);

Параметры

[in] FileObject

Указатель на уже открытый объект файла.

[in] Instance

Указатель непрозрачного экземпляра для экземпляра, связанного с этим объектом файла.

[out] IsDirectory

Указатель на логическую переменную, предоставляемую вызывающим. При возврате эта переменная получает значение TRUE , если объект файла представляет каталог, в противном случае — FALSE .

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

FltIsDirectory возвращает STATUS_SUCCESS или соответствующее значение NTSTATUS, например следующее:

Код возврата	Описание
STATUS_NOT_SUPPORTED	Этот код ошибки возвращается, если файловая система не поддерживает контексты потоков. Обратите внимание, что начиная с Windows Vista , FltIsDirectory будет возвращать сведения о каталоге даже для файловых систем, которые не поддерживают контексты потоков.

Код возврата

Описание

STATUS_NOT_SUPPORTED

Этот код ошибки возвращается, если файловая система не поддерживает контексты потоков. Обратите внимание, что начиная с Windows Vista , FltIsDirectory будет возвращать сведения о каталоге даже для файловых систем, которые не поддерживают контексты потоков.

FltIsDirectory извлекает нужные сведения из внутреннего диспетчера контекста потока диспетчера фильтров. Диспетчер фильтров кэширует эти сведения для будущих запросов в этом потоке.

Примечание Эта подпрограмма может вызываться только для открытого объекта файла.

Требования

Требование	Значение
Минимальная версия клиента	Эта подпрограмма доступна в накопительном пакете обновления 1 для Microsoft Windows 2000 с пакетом обновления 1 (SP4), Windows XP с пакетом обновления 2 (SP2), Microsoft Windows Server 2003 с пакетом обновления 1 (SP1) и более поздних версиях. Обратите внимание, что эта подпрограмма недоступна в Windows 2000 с пакетом обновления 4 (SP4) или более ранней версии.
Целевая платформа	Универсальное
Верхняя часть	fltkernel.h (включая FltKernel.h)
Библиотека	Fltmgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL

См. также раздел

FsRtlSupportsPerStreamContexts

Share via