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 结构的指针,FltGetFileNameInformationFltGetFileNameInformationUnsafeFltGetTunneledName。 此参数是必需的,不能 NULL

返回值

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

言论

FltParseFileNameInformation 分析FLT_FILE_NAME_INFORMATION结构的 名称 成员,并使用结果设置 的值,Share扩展StreamFinalComponentParentDir,以及 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”

ParentDirNULL

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

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

要求

要求 价值
最低支持的客户端 在 Windows XP SP2 及更高版本的 Windows作系统中可用。
目标平台 普遍
标头 fltkernel.h (包括 Fltkernel.h)
FltMgr.lib
DLL Fltmgr.sys
IRQL <= APC_LEVEL

另请参阅

FLT_FILE_NAME_INFORMATION

FltGetDestinationFileNameInformation

FltGetFileNameInformation

FltGetFileNameInformationUnsafe

FltGetTunneledName

FltParseFileName