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

Weitere Informationen

FilterClose

FilterGetInformation