FilterDetach 関数 (fltuser.h)

FilterDetach 関数は、指定されたミニフィルターインスタンスを特定のボリュームからデタッチします。

構文

HRESULT FilterDetach(
  [in]           LPCWSTR lpFilterName,
  [in]           LPCWSTR lpVolumeName,
  [in, optional] LPCWSTR lpInstanceName
);

[in] lpFilterName

インスタンスがスタックからデタッチされるミニフィルターの名前を含む、null で終わるワイド文字列へのポインター。このパラメーターは必須であり、 NULL にすることはできません。

[in] lpVolumeName

インスタンスが現在アタッチされているボリュームの名前を含む null で終わるワイド文字列へのポインター。

lpVolumeName 入力文字列には、次のいずれかを指定できます。末尾の円記号 (\) は省略可能です。

ドライブ文字 ("D:\" など)
"c:\mnt\edrive\" などのボリュームマウントポイントへのパス
"\?" などの一意 のボリューム識別子 (ボリューム GUID 名とも呼ばれます)\Volume{7603f260-142a-11d4-ac67-806d6172696f}\"
"\Device\HarddiskVolume1\" などの非永続デバイス 名 (ターゲット名 または NT デバイス名とも呼ばれます)

このパラメーターは必須であり、 NULL にすることはできません。

[in, optional] lpInstanceName

削除するインスタンスのインスタンス名を含む null で終わるワイド文字列へのポインター。このパラメーターは省略可能であり、 NULL にすることができます。 NULL の場合は、一致する最も高いインスタンスが削除されます。

FilterDetach は、成功した場合S_OKを返します。それ以外の場合は、エラー値を返します。

FilterDetach は、FltDetachVolume に相当する Win32 です。

FilterDetach は、ミニフィルターインスタンスをボリュームからデタッチし、インスタンスを破棄します。

ミニフィルターインスタンスをボリュームにアタッチするには、FilterAttach または FilterAttachAtAltitude を呼び出します。