FilterLoad-Funktion (fltuser.h)

Artikel
08/23/2023

Die FilterLoad-Funktion lädt dynamisch einen Minifiltertreiber in das System.

Syntax

HRESULT FilterLoad(
  [in] LPCWSTR lpFilterName
);

Parameter

[in] lpFilterName

Zeiger auf eine mit NULL beendete Breitzeichenzeichenfolge, die den Dienstnamen des Minifiltertreibers angibt. Dieser Parameter ist erforderlich und darf nicht NULL oder eine leere Zeichenfolge sein.

Rückgabewert

FilterLoad gibt bei erfolgreicher Ausführung S_OK zurück. Andernfalls wird einer der folgenden Fehlerwerte zurückgegeben:

Rückgabecode	Beschreibung
HRESULT_FROM_WIN32 (ERROR_ALREADY_EXISTS)	Der Minifiltertreiber wird bereits ausgeführt.
HRESULT_FROM_WIN32 (ERROR_FILE_NOT_FOUND)	Es wurde kein passender Minifiltertreiber gefunden.
HRESULT_FROM_WIN32 (ERROR_SERVICE_ALREADY_RUNNING)	Der Minifiltertreiber wird bereits ausgeführt.
HRESULT_FROM_WIN32 (ERROR_BAD_EXE_FORMAT)	Das Ladeimage für den minifilter-Treiber, der durch lpFilterName angegeben wird, ist ungültig.
HRESULT_FROM_WIN32 (ERROR_BAD_DRIVER)	Das Ladeimage für den minifilter-Treiber, der durch lpFilterName angegeben wird, ist ungültig.
HRESULT_FROM_WIN32 (ERROR_INVALID_IMAGE_HASH)	Der Minifiltertreiber verfügt über eine ungültige digitale Signatur.

Hinweise

FilterLoad ist die Win32-Entsprechung von FltLoadFilter.

Eine Anwendung im Benutzermodus, die eine Abhängigkeit von einem Kernelmodus-Minifiltertreiber aufweist, kann den Minifiltertreiber laden, indem Sie FilterLoad aufrufen.

Aufrufer von FilterLoad müssen über SeLoadDriverPrivilege (die LUID von SE_LOAD_DRIVER_PRIVILEGE) verfügen, um einen Minifiltertreiber zu laden oder zu entladen. Dieses Recht wird durch die SE_LOAD_DRIVER_NAME Namenskonstante benannt. (Berechtigungen werden in der Dokumentation zum Microsoft Windows Software Development Kit (SDK) für Windows 7 und .NET Framework 4.0 beschrieben.)

Um den Minifiltertreiber zu entladen, rufen Sie FilterUnload auf.