FilterCreate-Funktion (fltuser.h)
Die FilterCreate-Funktion erstellt ein Handle für den angegebenen Minifilter.
Syntax
HRESULT FilterCreate(
[in] LPCWSTR lpFilterName,
[out] HFILTER *hFilter
);
Parameter
[in] lpFilterName
Zeiger auf eine mit NULL beendete Breitzeichenzeichenfolge, die den Namen des Minifilters enthält. Dieser Parameter ist erforderlich und darf nicht NULL sein.
[out] hFilter
Zeiger auf eine vom Aufrufer zugeordnete Variable, die ein Handle für den Minifilter empfängt, wenn der Aufruf von FilterCreate erfolgreich ist; Andernfalls empfängt sie INVALID_HANDLE_VALUE.
Rückgabewert
FilterCreate gibt bei erfolgreicher Ausführung S_OK zurück. Andernfalls wird ein Fehlerwert zurückgegeben.
Hinweise
Eine Anwendung im Benutzermodus ruft FilterCreate auf, um ein Handle zu erstellen, das für die Kommunikation mit einem Kernelmodus-Minifilter verwendet werden kann. Das zurückgegebene Minifilterhandle kann als Parameter an Funktionen wie FilterGetInformation übergeben werden.
Um ein von FilterCreate zurückgegebenes Filterhandle zu schließen, rufen Sie FilterClose auf.
Anforderungen
| Zielplattform | Universell |
| Header | fltuser.h (fltuser.h einschließen) |
| Bibliothek | FltLib.lib |
| DLL | FltLib.dll |