FltParseFileNameInformation 函式 (fltkernel.h)
FltParseFileNameInformation 會剖析 FLT_FILE_NAME_INFORMATION 結構的內容。
語法
NTSTATUS FLTAPI FltParseFileNameInformation(
[in, out] PFLT_FILE_NAME_INFORMATION FileNameInformation
);
參數
[in, out] FileNameInformation
先前呼叫 FltGetDestinationFileNameInformation、FltGetFileNameInformation、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 作業系統。 |
目標平台 | Universal |
標頭 | fltkernel.h (包含 Fltkernel.h) |
程式庫 | FltMgr.lib |
Dll | Fltmgr.sys |
IRQL | <= APC_LEVEL |
另請參閱
FltGetDestinationFileNameInformation