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

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

Синтаксис

PFSRTL_PER_FILE_CONTEXT FsRtlLookupPerFileContext(
  [in]           PVOID *PerFileContextPointer,
  [in, optional] PVOID OwnerId,
  [in, optional] PVOID InstanceId
);

Параметры

[in] PerFileContextPointer

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

[in, optional] OwnerId

Указатель на выделенную драйвером переменную фильтра, которая однозначно идентифицирует владельца структуры контекста файла. Формат этой переменной зависит от драйвера фильтра. Этот параметр является необязательным, но должен быть неNULL, если InstanceId не являетсяNULL.

[in, optional] InstanceId

Указатель на выделенную драйвером переменную фильтра, которая может использоваться для различения структур контекста каждого файла, созданных одним драйвером фильтра. Формат этой переменной зависит от драйвера фильтра. Этот параметр является необязательным.

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

Указатель на первую структуру FSRTL_PER_FILE_CONTEXT, которая соответствует OwnerId и InstanceId, если задано или NULL, если совпадение не найдено или файловая система не поддерживает контексты для каждого файла.

Замечания

Не указывая OwnerID и InstanceId, драйвер фильтра может искать первый контекст, связанный с файлом.

Если файловая система не поддерживает объекты контекста для каждого файла, возвращается NULL. Используйте макрос FsRtlSupportsPerFileContexts, чтобы определить, поддерживает ли файловая система объекты контекста для каждого файла.

Требования

См. также

FSRTL_PER_FILE_CONTEXT

FsRtlGetPerFileContextPointer

FsRtlInsertPerFileContext

FsRtlRemovePerFileContext

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