FltParseFileNameInformation 函数 (fltkernel.h)
FltParseFileNameInformation 分析 FLT_FILE_NAME_INFORMATION 结构的内容。
语法
NTSTATUS FLTAPI FltParseFileNameInformation(
[in, out] PFLT_FILE_NAME_INFORMATION FileNameInformation
);
参数
[in, out] FileNameInformation
指向上一次 调用 fltGetDestinationFileNameInformation返回的 FLT_FILE_NAME_INFORMATION 结构的指针,FltGetFileNameInformation、FltGetFileNameInformationUnsafe或 FltGetTunneledName。 此参数是必需的,不能 NULL。
返回值
FltParseFileNameInformation 返回STATUS_SUCCESS或相应的 NTSTATUS 错误代码。
言论
FltParseFileNameInformation 分析FLT_FILE_NAME_INFORMATION结构的 名称 成员,并使用结果设置 卷的值,Share扩展、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”
流:NULL
FinalComponent:“TestRe~1.txt”
ParentDir:NULL
调用方不得修改 FileNameInformation 结构的内容,因为筛选器管理器将缓存此结构,以便所有微型筛选器驱动程序都可以使用它。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 在 Windows XP SP2 及更高版本的 Windows作系统中可用。 |
目标平台 | 普遍 |
标头 | fltkernel.h (包括 Fltkernel.h) |
库 | FltMgr.lib |
DLL | Fltmgr.sys |
IRQL | <= APC_LEVEL |
另请参阅
FltGetDestinationFileNameInformation