Fonction FilterCreate (fltuser.h)
La fonction FilterCreate crée un handle pour le minifiltre donné.
Syntaxe
HRESULT FilterCreate(
[in] LPCWSTR lpFilterName,
[out] HFILTER *hFilter
);
Paramètres
[in] lpFilterName
Pointeur vers une chaîne de caractères larges terminée par null contenant le nom du minifiltre. Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.
[out] hFilter
Pointeur vers une variable allouée par l’appelant qui reçoit un handle pour le minifiltre si l’appel à FilterCreate réussit ; sinon, il reçoit INVALID_HANDLE_VALUE.
Valeur retournée
FilterCreate retourne S_OK en cas de réussite. Sinon, il retourne une valeur d’erreur.
Notes
Une application en mode utilisateur appelle FilterCreate pour créer un handle qui peut être utilisé pour communiquer avec un minifiltre en mode noyau. Le handle de minifiltre retourné peut être passé en tant que paramètre à des fonctions telles que FilterGetInformation.
Pour fermer un handle de filtre retourné par FilterCreate, appelez FilterClose.
Spécifications
| Plateforme cible | Universal |
| En-tête | fltuser.h (inclure Fltuser.h) |
| Bibliothèque | FltLib.lib |
| DLL | FltLib.dll |