FltDeleteFileContext 関数 (fltkernel.h)

[アーティクル]
08/07/2023

FltDeleteFileContext ルーチンは、特定のミニフィルタードライバーが特定のファイルに対して設定したファイルコンテキストを取得および削除します。

構文

NTSTATUS FLTAPI FltDeleteFileContext(
  [in]  PFLT_INSTANCE Instance,
  [in]  PFILE_OBJECT  FileObject,
  [out] PFLT_CONTEXT  *OldContext
);

パラメーター

[in] Instance

呼び出し元の不透明なインスタンスポインター。このパラメーターは必須であり、 NULL にすることはできません。

[in] FileObject

ファイルのファイルオブジェクトポインター。このパラメーターは必須であり、 NULL にすることはできません。

[out] OldContext

削除されたコンテキストのアドレスを受け取る呼び出し元によって割り当てられた変数へのポインター。一致するコンテキストが見つからない場合、この変数はNULL_CONTEXTを受け取ります。このパラメーターは省略可能であり、 NULL にすることができます。このパラメーターの詳細については、次の「解説」セクションを参照してください。

戻り値

FltDeleteFileContext は 、次のいずれかのSTATUS_SUCCESSまたは適切な NTSTATUS 値を返します。

リターンコード	説明
STATUS_NOT_FOUND	一致するコンテキストが見つかりませんでした。これはエラーコードです。
STATUS_NOT_SUPPORTED	ファイルコンテキストは、このファイルではサポートされていません。これはエラーコードです。

注釈

コンテキストの詳細については、「ミニフィルターコンテキストについて」を参照してください。

コンテキストは参照カウントされるため、通常、ミニフィルタードライバーが FltDeleteFileContext や FltDeleteContext などのルーチンを呼び出してコンテキストを明示的に削除する必要はありません。

ミニフィルタードライバーは FltDeleteFileContext を呼び出して、 FltSetFileContext を呼び出して、以前にファイルに対して設定したファイルコンテキストを取得および削除します。

入力時に OldContext パラメーターが NULL で、一致するファイルコンテキストが見つかった場合、 FltDeleteFileContext は、ミニフィルタードライバーの FltSetFileContext への以前の呼び出しによって追加された参照を解放します。通常、削除されたコンテキストは、未処理の参照がない限り、すぐに解放されます (たとえば、コンテキストが別のスレッドによって引き続き使用されているため)。

OldContext パラメーターが NULL ではなく、一致するファイルコンテキストが見つかり、返された場合、呼び出し元は FltSetFileContext によって追加された参照を解放する必要があります。この参照を解放するには、ミニフィルタードライバーは、必要なクリーンアップを実行した後、できるだけ早く削除されたファイルコンテキストで FltReleaseContext を呼び出す必要があります。

新しいコンテキストを割り当てるには、 FltAllocateContext を呼び出します。

特定のファイルに対してファイルコンテキストがサポートされているかどうかを確認するには、 FltSupportsFileContexts または FltSupportsFileContextsEx を呼び出します。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降にのみ適用される
対象プラットフォーム	ユニバーサル
Header	fltkernel.h (Fltkernel.h を含む)
Library	FltMgr.lib
IRQL	<= APC_LEVEL