FltUntagFile 関数 (fltkernel.h)

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

FltUntagFile は、ファイルまたはディレクトリから再解析ポイントを削除します。

構文

NTSTATUS FLTAPI FltUntagFile(
  [in]           PFLT_INSTANCE InitiatingInstance,
  [in]           PFILE_OBJECT  FileObject,
  [in]           ULONG         FileTag,
  [in, optional] GUID          *Guid
);

パラメーター

[in] InitiatingInstance

この I/O 要求を開始したミニフィルタードライバーインスタンスの不透明なインスタンスポインター。このパラメーターは必須であり、 NULL にすることはできません。

[in] FileObject

再解析ポイントを削除するファイルまたはディレクトリのファイルオブジェクトへのポインター。 FILE_WRITE_DATAアクセスするには、ファイルオブジェクトを開く必要があります。このパラメーターは必須であり、 NULL にすることはできません。

[in] FileTag

ポイントタグを再解析します。このパラメーターで指定するタグは、削除する再解析ポイントのタグと一致している必要があります。

[in, optional] Guid

再解析ポイントの種類を一意に識別するグローバル一意識別子 (GUID)。 FileTag が Microsoft タグでない場合、このパラメーターは必須であり、NULL にすることはできません。このパラメーターで指定する GUID は、削除する再解析ポイントの GUID と一致している必要があります。

戻り値

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

リターンコード	説明
STATUS_IO_REPARSE_TAG_MISMATCH	呼び出し元によって指定された再解析タグが、削除する再解析ポイントのタグと一致しませんでした。これはエラーコードです。
STATUS_REPARSE_ATTRIBUTE_CONFLICT	呼び出し元によって指定された再解析 GUID が、削除する再解析ポイントの GUID と一致しませんでした。これはエラーコードです。

注釈

ミニフィルタードライバーでは、再解析ポイントを削除するには、FSCTL_DELETE_REPARSE_POINTの代わりに FltUntagFile を使用する必要があります。

ミニフィルタードライバーは、 FltTagFile を呼び出すことによって、ファイルまたはディレクトリに再解析タグを設定できます。

再解析ポイントの詳細については、Microsoft Windows SDKドキュメントを参照してください。

要件

要件	値
対象プラットフォーム	ユニバーサル
Header	fltkernel.h (Fltkernel.h を含む)
Library	FltMgr.lib
[DLL]	Fltmgr.sys
IRQL	PASSIVE_LEVEL