FltGetTunneledName 関数 (fltkernel.h)

[アーティクル]
10/30/2024

FltGetTunneledName ルーチンは、FltGetFileNameInformation、fltGetFileNameInformationUnsafe、または FltGetGetDestinationFileNameInformation呼び出してファイルに対して返された正規化された名前を指定して、ファイルのトンネル名を取得します。

構文

NTSTATUS FLTAPI FltGetTunneledName(
  [in]  PFLT_CALLBACK_DATA         CallbackData,
  [in]  PFLT_FILE_NAME_INFORMATION FileNameInformation,
  [out] PFLT_FILE_NAME_INFORMATION *RetTunneledFileNameInformation
);

パラメーター

[in] CallbackData

I/O 操作 (FLT_CALLBACK_DATA) のコールバックデータ構造体へのポインター。このパラメーターは必須であり、NULLすることはできません。

[in] FileNameInformation

FltGetFileNameInformation、FltGetFileNameInformationUnsafe、またはファイルの FltGetDestinationFileNameInformation をする前の呼び出しによって返された正規化された名前情報を含む FLT_FILE_NAME_INFORMATION 構造体へのポインター。

[out] RetTunneledFileNameInformation

トンネリングされたファイル名を含む新しく割り当てられた構造体のアドレスを受け取る呼び出し元によって割り当てられた変数へのポインター。トンネル名が見つからない場合、この変数は NULL受け取ります。このパラメーターは必須であり、入力時に NULL することはできません。

戻り値

FltGetTunneledName 、トンネリングされた名前が見つかった場合、またはファイルのトンネル名がない場合にSTATUS_SUCCESSを返します。それ以外の場合は、次のような NTSTATUS 値を返します。

リターンコード	形容
STATUS_INSUFFICIENT_RESOURCES	FltGetTunneledName プール割り当てエラーが発生しました。これはエラーコードです。

備考

NTFS や FAT などのファイルシステムでは、ボリュームごとのトンネルキャッシュを使用して、名前変更、リンク、または削除されるファイルのファイル名やその他のメタデータを簡単に保持します。ファイル名のトンネリングにより、FltGetFileNameInformation、fltGetFileNameInformationUnsafe、または FltGetDestinationFileNameInformation への事前操作呼び出しによって返される正規化されたファイル名情報の最終コンポーネントが無効になる可能性があります。

ミニフィルタードライバーが、作成 (IRP_MJ_CREATE) の事前操作コールバックルーチン (PFLT_PRE_OPERATION_CALLBACK) で正規化されたファイル名情報を取得する場合、FILE_INFORMATION_CLASS が FileLinkInformationに設定されたハードリンク (IRP_MJ_SET_INFORMATION)、または名前変更操作 (FILE_INFORMATION_CLASSが FileRenameInformationに設定 IRP_MJ_SET_INFORMATION) その後のコールバックルーチン (PFLT_POST_OPERATION_CALLBACK) から FltGetTunneledName を呼び出して、ファイルの正しいファイル名情報を取得する必要があります。

正規化されたファイル名情報のみがトンネリングの影響を受けます。フィルターマネージャーでは、トンネリングによって短い名前が長い名前に変更される可能性があるため、作成、ハードリンク、または名前変更操作が実際に行われるまで、最終的なコンポーネントを正規化することはできません。したがって、ミニフィルタードライバーは、操作後コールバックルーチンから FltGetTunneledName を呼び出して、事前操作コールバックルーチンで取得された正規化されたファイル名情報が有効かどうかを判断する必要があります。

正規化されたファイル名の情報の詳細については、FLT_FILE_NAME_INFORMATIONを参照してください。

短いファイル名または開いているファイル名の情報のみを取得するミニフィルタードライバーは、FltGetTunneledName呼び出さないでください。

FltGetFileNameInformation、fltGetFileNameInformationUnsafe、または preoperation コールバックルーチンで FltGetDestinationFileNameInformation を呼び出した後、ミニフィルタードライバーは、返された FileNameInformation ポインターをプリ操作コールバックルーチンの CompletionContext 構造体に格納する必要があります。これにより、事後処理コールバックは、このポインターを FileNameInformation パラメーターで FltGetTunneledName渡すことができます。

手記

ファイル名トンネリングは、この方法で作成、ハードリンク、名前変更の操作にのみ影響します。読み取りと書き込みなど、他の I/O 操作には影響しません。

次のペアの操作により、ファイル名名前トンネリングが発生する可能性があります。

delete(name)/create(name)
delete(name)/rename(source, name)
rename(name, newname)/create(name)
rename(name, newname)/rename(source, name)

ファイルのトンネル名が見つからない場合、RetTunneledFileNameInformation パラメーターは NULL受け取ります。

FltGetTunneledName正常に呼び出された後、呼び出し元は、fltReleaseFileNameInformation呼び出して不要になったときに、RetTunneledFileNameInformation を解放し、FileNameInformation ポインターをします。

FltGetTunneledName は、ミニフィルタードライバーのIRP_MJ_CREATEまたはIRP_MJ_SET_INFORMATIONのポスト操作コールバックルーチンからのみ呼び出す必要があります。他 種類の I/O 操作に対して、操作後コールバックルーチンから FltGetTunneledName を呼び出すか、プリ操作コールバックルーチンから呼び出すことは、プログラミングエラーです。

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

ファイルトンネリングを使用すると、ファイルシステムに依存するプログラムとの互換性により、ファイルメタ情報を短期間保持できます。たとえば、安全な保存プロセスの場合などです。トンネリングでは、ファイルの長い名前と短い名前 (8.3) の間の関連付けが保持されます。ディレクトリからファイル名を削除すると (名前の変更または削除)、その短い名前と長い名前のペアと作成時間がトンネルキャッシュに保存され、削除された名前でキーが設定されます。名前がディレクトリに追加されると (名前の変更または作成)、キャッシュが検索され、復元する情報があるかどうかを判断します。キャッシュは、ディレクトリのインスタンスごとに有効です。ディレクトリが削除されると、そのキャッシュが削除されます。

必要条件

要件	価値
ターゲットプラットフォームの	万国
ヘッダー	fltkernel.h (Fltkernel.h を含む)
ライブラリ	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL

次の方法で共有

FltGetTunneledName 関数 (fltkernel.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース