FltParseFileNameInformation 函式 (fltkernel.h)

發行項
02/26/2024

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 結構的內容，因為篩選管理員會快取此結構，讓所有迷你篩選驅動程式都可以使用它。

注意如果呼叫端嘗試剖析字串，而不是FLT_FILE_NAME_INFORMATION結構，請使用 FltParseFileName 例程，而不是 FltParseFileNameInformation。

規格需求

需求	值
最低支援的用戶端	適用於 Windows XP SP2 和更新版本的 Windows 作業系統。
目標平台	Universal
標頭	fltkernel.h (包含 Fltkernel.h)
程式庫	FltMgr.lib
Dll	Fltmgr.sys
IRQL	<= APC_LEVEL