共用方式為


FltParseFileNameInformation 函式 (fltkernel.h)

FltParseFileNameInformation 剖析 FLT_FILE_NAME_INFORMATION 結構的內容。

語法

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

參數

[in, out] FileNameInformation

先前呼叫 fltGetDestinationFileNameInformation FltGetFileNameInformationFltGetFileNameInformationUnsafeFltGetTunneledName所傳回 FLT_FILE_NAME_INFORMATION 結構的指標。 這是必要參數,而且無法 NULL

傳回值

FltParseFileNameInformation 會傳回STATUS_SUCCESS或適當的 NTSTATUS 錯誤碼。

言論

FltParseFileNameInformation 剖析FLT_FILE_NAME_INFORMATION結構的 Name 成員,並使用結果來設定 Volume的值,ShareExtensionStreamFinalComponentParentDir,以及 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