FltParseFileNameInformation 関数 (fltkernel.h)

[アーティクル]
02/29/2024

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"

Stream: NULL

FinalComponent: "TestRe~1.txt"

ParentDir: NULL

呼び出し元は FileNameInformation 構造体の内容を変更しないでください。これは、フィルターマネージャーがこの構造体をキャッシュして、すべてのミニフィルタードライバーが使用できるようにするためです。

メモ呼び出し元がFLT_FILE_NAME_INFORMATION構造体ではなく文字列を解析しようとしている場合は、 FltParseFileNameInformation の代わりに FltParseFileName ルーチンを使用します。

要件

要件	値
サポートされている最小のクライアント	Windows XP SP2 以降のバージョンの Windows オペレーティングシステムで使用できます。
対象プラットフォーム	ユニバーサル
Header	fltkernel.h (Fltkernel.h を含む)
Library	FltMgr.lib
[DLL]	Fltmgr.sys
IRQL	<= APC_LEVEL