Функция FsRtlInsertPerFileContext (ntifs.h)

Статья
08/07/2023

Подпрограмма FsRtlInsertPerFileContext связывает FSRTL_PER_FILE_CONTEXT объект с заданным драйвером контекстным объектом для файла.

Синтаксис

NTSTATUS FsRtlInsertPerFileContext(
  [in] PVOID                   *PerFileContextPointer,
  [in] PFSRTL_PER_FILE_CONTEXT Ptr
);

Параметры

[in] PerFileContextPointer

Указатель на непрозрачный указатель, используемый пакетом библиотеки времени выполнения файловой системы (FSRTL) для отслеживания контекстов файлов. Чтобы получить этот указатель из объекта файла, используйте макрос FsRtlGetPerFileContextPointer .

[in] Ptr

Указатель на структуру контекста для конкретного драйвера.

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

Подпрограмма FsRtlInsertPerFileContext возвращает STATUS_SUCCESS или соответствующий код ошибки, например:

Код возврата	Описание
STATUS_INVALID_DEVICE_REQUEST	Базовая файловая система не поддерживает контексты фильтрации файлов. Макрос FsRtlSupportsPerFileContexts можно использовать для проверка, поддерживает ли файловая система объекты контекста файла.
STATUS_INSUFFICIENT_RESOURCES	Системе не удалось выделить ресурсы (обычно это память).

Макрос FsRtlGetPerFileContextPointer возвращает непрозрачный указатель, используемый пакетом библиотеки среды выполнения файловой системы (FSRTL) для отслеживания контекстов файлов. Макрос возвращает значение NULL , если файловая система не поддерживает использование объектов контекста для каждого файла с файлами.

Макрос FsRtlGetPerFileContextPointer возвращает указатель, передаваемый в такие подпрограммы, как FsRtlInsertPerFileContext, FsRtlLookupPerFileContext и FsRtlRemovePerFileContext.

Дополнительные сведения об использовании и создании объектов контекста см. в разделе Отслеживание Per-File контекста в устаревшем драйвере фильтра файловой системы.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Целевая платформа	Универсальное
Верхняя часть	ntifs.h (включая FltKernel.h, Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<=APC_LEVEL

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

FSRTL_PER_FILE_CONTEXT

FsRtlLookupPerFileContext

FsRtlRemovePerFileContext

Отслеживание контекста Per-File в устаревшем драйвере фильтра файловой системы

Share via