FilterUnload-Funktion (fltuser.h)
Eine Anwendung, die einen unterstützenden Minifilter durch Aufrufen von FilterLoad geladen hat, kann den Minifilter entladen, indem die FilterUnload-Funktion aufgerufen wird.
Syntax
HRESULT FilterUnload(
[in] LPCWSTR lpFilterName
);
Parameter
[in] lpFilterName
Zeiger auf eine mit NULL beendete Breitzeichenzeichenfolge, die den gleichen Minifilternamen enthält, der an FilterLoad übergeben wurde. Dieser Parameter ist erforderlich und darf nicht NULL oder eine leere Zeichenfolge sein.
Rückgabewert
FilterUnload gibt bei erfolgreicher Ausführung S_OK zurück. Andernfalls wird ein Fehlerwert zurückgegeben.
Hinweise
FilterUnload ist die Win32-Entsprechung von FltUnloadFilter.
FilterUnload sucht nach einem registrierten Minifilter, dessen Dienstname mit dem angegebenen lpFilterName übereinstimmt, und ruft die FilterUnloadCallback-Routine (PFLT_FILTER_UNLOAD_CALLBACK) dieses Minifilters auf.
Wenn der Minifilter keine FilterUnloadCallback-Routine registriert hat, schlägt der Aufruf von FilterUnload fehl.
Aufrufer von FilterUnload müssen über SeLoadDriverPrivilege (luID von SE_LOAD_DRIVER_PRIVILEGE) verfügen, um einen Minifiltertreiber laden oder entladen zu können. Diese Berechtigung wird durch die SE_LOAD_DRIVER_NAME Namenskonstante benannt. (Berechtigungen werden in der Dokumentation microsoft Windows Software Development Kit (SDK) für Windows 7 und .NET Framework 4.0 beschrieben.)
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| Header | fltuser.h (fltuser.h einschließen) |
| Bibliothek | FltLib.lib |
| DLL | FltLib.dll |