FltParseFileNameInformation 函数 (fltkernel.h)
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 结构的内容，因为筛选器管理器会缓存此结构，以便所有微筛选器驱动程序都可以使用它。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 适用于 Windows XP SP2 及更高版本的 Windows 操作系统。 |
| 目标平台 | 通用 |
| 标头 | fltkernel.h (包括 Fltkernel.h) |
| Library | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |
另请参阅
FltGetDestinationFileNameInformation