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

Voir aussi

FilterClose

FilterGetInformation