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

Статья
10/26/2024

FltMupGetProviderInfoFromFileObject извлекает сведения о поставщике, соответствующие объекту файла.

Синтаксис

NTSTATUS FLTAPI FltMupGetProviderInfoFromFileObject(
  PFLT_INSTANCE Instance,
  PFILE_OBJECT  FileObject,
  ULONG         Level,
  PVOID         Buffer,
  PULONG        BufferSize
);

Параметры

Instance

[in] Непрозрачный указатель на экземпляр фильтра, связанный с этим объектом файла. Этот параметр является обязательным и не может иметь значение NULL.

FileObject

[in] Указатель на объект файла, для которого требуется получить сведения о поставщике. Этот параметр является обязательным и не может иметь значение NULL.

Level

[in] Уровень информации, возвращаемой этой подпрограммой. Дополнительные сведения о возможных значениях этого параметра см. в FsRtlMupGetProviderInfoFromFileObject.

Buffer

[out] Указатель на буфер, получающий сведения о поставщике. Возвращаемые данные основаны на указанных уровне. Этот буфер должен быть достаточно большим для хранения сведений, запрошенных параметром Level.

BufferSize

[in/out] Указатель на переменную, указывающую размер буфера в байтах, на который указывает параметр Buffer. При входных данных эта переменная указывает размер буфера. В выходных данных эта переменная получает количество байтов, записанных в буфер.

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

FltMupGetProviderInfoFromFileObject возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае возвращается соответствующий код NTSTATUS.

Замечания

Эта подпрограмма необходима для обработки случаев, когда поставщики регистрируются с помощью FsRtlRegisterUncProviderEx. Имя устройства для объектов файлов для такого поставщика будет \Device\Mup.

Фильтры могут использовать эту подпрограмму в следующих целях:

Чтобы иметь возможность фильтровать определенные перенаправления.
Чтобы найти средство перенаправления, поддерживающее файловый объект, чтобы они могли обойти возможные ошибки в перенаправлениях.

MUP (несколько поставщиков UNC) нельзя выгрузить для этого вызова.

Вызывающий объект гарантирует, что FileObject будет действителен в течение срока вызова.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 11 версии 24H2
заголовка	fltkernel.h
IRQL	<= APC_LEVEL

См. также

FsRtlMupGetProviderInfoFromFileObject

FsRtlRegisterUncProviderEx

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