Freigeben über


FilterLoad-Funktion (fltuser.h)

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

Syntax

HRESULT FilterLoad(
  [in] LPCWSTR lpFilterName
);

Die Parameter

[in] lpFilterName

Zeigen Sie auf eine mit Null beendete breite Zeichenfolge, 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 gibt sie einen der folgenden Fehlerwerte zurück:

Rückgabecode Description
HRESULT_FROM_WIN32 (ERROR_ALREADY_EXISTS)
Der Minifiltertreiber wird bereits ausgeführt.
HRESULT_FROM_WIN32 (ERROR_FILE_NOT_FOUND)
Es wurde kein übereinstimmener 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 durch lpFilterName angegebenen Minifiltertreiber ist ungültig.
HRESULT_FROM_WIN32 (ERROR_BAD_DRIVER)
Das Ladeimage für den durch lpFilterName angegebenen Minifiltertreiber ist ungültig.
HRESULT_FROM_WIN32 (ERROR_INVALID_IMAGE_HASH)
Der Minifiltertreiber verfügt über eine ungültige digitale Signatur.

Bemerkungen

FilterLoad ist das Win32-Äquivalent von FltLoadFilter.

Eine Benutzermodusanwendung, die von einem Kernelmodus-Minifiltertreiber abhängig ist, kann den Minifiltertreiber durch Aufrufen von FilterLoad laden.

Aufrufer von FilterLoad müssen seLoadDriverPrivilege (die LUID von SE_LOAD_DRIVER_PRIVILEGE) besitzen, um einen Minifiltertreiber zu laden oder zu entladen. Diese Berechtigung wird durch die SE_LOAD_DRIVER_NAME Namenskonstante benannt. (Berechtigungen werden im Microsoft Windows Software Development Kit (SDK) für Windows 7- und .NET Framework 4.0-Dokumentation beschrieben.)

Rufen Sie "FilterUnload" auf, um den Minifiltertreiber zu entladen.

Anforderungen

Anforderung Wert
Zielplattform Universal
Header fltuser.h (include Fltuser.h)
Library FltLib.lib
DLL FltLib.dll

Siehe auch

FilterUnload

FltLoadFilter

HRESULT_FROM_WIN32