FltMupGetProviderInfoFromFileObject 函数 (fltkernel.h)

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

筛选器可以将此例程用于以下目的:

  • 能够筛选特定的重定向程序。
  • 若要查找支持文件对象的重定向程序,以便他们可以解决重定向程序中可能存在的 bug。

无法为此调用卸载 MUP (多个 UNC 提供程序)。

调用方保证 FileObject 在调用期间有效。

要求

要求 价值
最低支持的客户端 Windows 11 版本 24H2
标头 fltkernel.h
IRQL <= APC_LEVEL

另请参阅

FsRtlMupGetProviderInfoFromFileObject

FsRtlRegisterUncProviderEx