Funzione FilterCreate (fltuser.h)
La funzione FilterCreate crea un handle per il minifilter specificato.
Sintassi
HRESULT FilterCreate(
[in] LPCWSTR lpFilterName,
[out] HFILTER *hFilter
);
Parametri
[in] lpFilterName
Puntatore a una stringa di caratteri wide con terminazione Null contenente il nome del minifilter. Questo parametro è obbligatorio e non può essere NULL.
[out] hFilter
Puntatore a una variabile allocata dal chiamante che riceve un handle per il minifilter se la chiamata a FilterCreate ha esito positivo; in caso contrario, riceve INVALID_HANDLE_VALUE.
Valore restituito
FilterCreate restituisce S_OK in caso di esito positivo. In caso contrario, restituisce un valore di errore.
Commenti
Un'applicazione in modalità utente chiama FilterCreate per creare un handle che può essere usato per comunicare con un minifilter in modalità kernel. L'handle minifilter restituito può essere passato come parametro a funzioni come FilterGetInformation.
Per chiudere un handle di filtro restituito da FilterCreate, chiamare FilterClose.
Requisiti
| Piattaforma di destinazione | Universale |
| Intestazione | fltuser.h (include Fltuser.h) |
| Libreria | FltLib.lib |
| DLL | FltLib.dll |