FilterLoad 関数 (fltuser.h)

FilterLoad 関数は、ミニフィルター ドライバーをシステムに動的に読み込みます。

構文

HRESULT FilterLoad(
  [in] LPCWSTR lpFilterName
);

パラメーター

[in] lpFilterName

ミニフィルター ドライバーのサービス名を指定する null で終わるワイド文字文字列へのポインター。 このパラメーターは必須であり、 NULL または空の文字列にすることはできません。

戻り値

FilterLoad は、成功した場合S_OKを返します。 それ以外の場合は、次のいずれかのエラー値が返されます。

リターン コード	説明
HRESULT_FROM_WIN32 (ERROR_ALREADY_EXISTS)	ミニフィルター ドライバーは既に実行されています。
HRESULT_FROM_WIN32 (ERROR_FILE_NOT_FOUND)	一致するミニフィルター ドライバーが見つかりませんでした。
HRESULT_FROM_WIN32 (ERROR_SERVICE_ALREADY_RUNNING)	ミニフィルター ドライバーは既に実行されています。
HRESULT_FROM_WIN32 (ERROR_BAD_EXE_FORMAT)	lpFilterName で指定されたミニフィルター ドライバーの読み込みイメージが無効です。
HRESULT_FROM_WIN32 (ERROR_BAD_DRIVER)	lpFilterName で指定されたミニフィルター ドライバーの読み込みイメージが無効です。
HRESULT_FROM_WIN32 (ERROR_INVALID_IMAGE_HASH)	ミニフィルター ドライバーに無効なデジタル署名があります。

解説

FilterLoad は、 FltLoadFilter と同等の Win32 です。

カーネル モード ミニフィルター ドライバーに依存するユーザー モード アプリケーションは、 FilterLoad を呼び出すことによってミニフィルター ドライバーを読み込むことができます。

FilterLoad の呼び出し元は、ミニフィルター ドライバーを読み込むかアンロードするには、SeLoadDriverPrivilege (SE_LOAD_DRIVER_PRIVILEGE の LUID) を持っている必要があります。 この特権の名前は、SE_LOAD_DRIVER_NAME名定数によって指定されます。 (特権については、Windows 7 用 Microsoft Windows ソフトウェア開発キット (SDK) および .NET Framework 4.0 のドキュメントを参照してください)。

ミニフィルター ドライバーをアンロードするには、 FilterUnload を呼び出します。

要件

対象プラットフォーム	ユニバーサル
Header	fltuser.h (Fltuser.h を含む)
Library	FltLib.lib
[DLL]	FltLib.dll

関連項目

FilterUnload

FltLoadFilter

HRESULT_FROM_WIN32