FltParseFileNameInformation 函数 (fltkernel.h)

项目
02/29/2024

FltParseFileNameInformation 分析 FLT_FILE_NAME_INFORMATION 结构的内容。

语法

NTSTATUS FLTAPI FltParseFileNameInformation(
  [in, out] PFLT_FILE_NAME_INFORMATION FileNameInformation
);

参数

[in, out] FileNameInformation

指向以前调用 FltGetDestinationFileNameInformation、FltGetFileNameInformation、FltGetFileNameInformationUnsafe 或 FltGetTunneledName 返回的FLT_FILE_NAME_INFORMATION结构的指针。此参数是必需的，不能为 NULL。

返回值

FltParseFileNameInformation 返回STATUS_SUCCESS或相应的 NTSTATUS 错误代码。

注解

FltParseFileNameInformation 分析FLT_FILE_NAME_INFORMATION结构的 Name 成员，并使用结果设置此结构的 Volume、Share、Extension、Stream、FinalComponent、ParentDir 和 NamesParsed 成员的值。有关详细信息，请参阅 FLT_FILE_NAME_INFORMATION。

下面是远程文件的规范化名称的示例：

\Device\LanManRedirector\MyServer\MyShare\Documents and Settings\MyUser\My Documents\Test Results.txt:stream1

FltParseFileNameInformation 分析此规范化名称，如下所示：

卷：“\Device\LanManRedirector”

共享：“\MyServer\MyShare”

扩展：“txt”

Stream：“：stream1”

FinalComponent：“Test Results.txt：stream1”

ParentDir： “\Documents and Settings\MyUser\My Documents”

下面是本地文件的已打开名称的示例：

\Device\HarddiskVolume1\Docume~1\MyUser\My Documents\TestRe~1.txt:stream1:$DATA

FltParseFileNameInformation 分析此打开的名称，如下所示：

卷：“\Device\HarddiskVolume1”

共享： NULL

扩展：“txt”

Stream：“：stream1：$DATA”

FinalComponent：“TestRe~1.txt：stream1：$DATA”

ParentDir：“\Docume~1\MyUser\My Documents”

下面是文件的短名称示例：

TestRe~1.txt

FltParseFileNameInformation 分析此短名称，如下所示：

卷： NULL

共享： NULL

扩展：“txt”

Stream：NULL

FinalComponent：“TestRe~1.txt”

ParentDir： NULL

调用方不得修改 FileNameInformation 结构的内容，因为筛选器管理器会缓存此结构，以便所有微筛选器驱动程序都可以使用它。

注意如果调用方尝试分析字符串而不是FLT_FILE_NAME_INFORMATION结构，请使用 FltParseFileName 例程而不是 FltParseFileNameInformation。

要求

要求	值
最低受支持的客户端	适用于 Windows XP SP2 及更高版本的 Windows 操作系统。
目标平台	通用
标头	fltkernel.h (包括 Fltkernel.h)
Library	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL