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”
數據流: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