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 |