FilterUnload 関数 (fltuser.h)
FilterLoad を呼び出してサポート ミニフィルターを読み込んだアプリケーションは、FilterUnload 関数を呼び出してミニフィルターをアンロードできます。
構文
HRESULT FilterUnload(
[in] LPCWSTR lpFilterName
);
パラメーター
[in] lpFilterName
FilterLoad に渡されたのと同じミニフィルター名を含む null で終わるワイド文字列へのポインター。 このパラメーターは必須であり、 NULL または空の文字列にすることはできません。
戻り値
FilterUnload は、成功した場合S_OKを返します。 それ以外の場合は、エラー値を返します。
注釈
FilterUnload は、 FltUnloadFilter に相当する Win32 です。
FilterUnload は、サービス名が指定された lpFilterName と一致する登録済みミニフィルターを検索し、そのミニフィルターの FilterUnloadCallback (PFLT_FILTER_UNLOAD_CALLBACK) ルーチンを呼び出します。
ミニフィルターが FilterUnloadCallback ルーチンを登録しなかった場合、 FilterUnload の呼び出しは失敗します。
FilterUnload の呼び出し元は、ミニフィルター ドライバーの読み込みまたはアンロードを行うために、SeLoadDriverPrivilege (SE_LOAD_DRIVER_PRIVILEGE の LUID) を持っている必要があります。 この特権には、SE_LOAD_DRIVER_NAME名定数によって名前が付けられます。 (特権については、Windows 7 用 Microsoft Windows ソフトウェア開発キット (SDK) および .NET Framework 4.0 のドキュメントを参照してください)。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| Header | fltuser.h (Fltuser.h を含む) |
| Library | FltLib.lib |
| [DLL] | FltLib.dll |