FwpmEngineOpen0, fonction (fwpmk.h)
La fonction FwpmEngineOpen0 ouvre une session au moteur de filtre.
Syntaxe
NTSTATUS FwpmEngineOpen0(
[in, optional] const wchar_t *serverName,
[in] UINT32 authnService,
[in, optional] SEC_WINNT_AUTH_IDENTITY_W *authIdentity,
[in, optional] const FWPM_SESSION0 *session,
[out] HANDLE *engineHandle
);
Paramètres
[in, optional] serverName
Pointeur vers une chaîne terminée par NULL qui spécifie le nom DNS standard du système sur lequel la session vers le moteur de filtre est ouverte. Les pilotes de légende doivent spécifier NULL pour ce paramètre.
[in] authnService
Service d’authentification à utiliser. Pour obtenir la liste des choix valides pour ce paramètre, consultez Authentication-Service constantes dans la section RPC de la documentation du Kit de développement logiciel (SDK) Microsoft Windows. Les pilotes de légende doivent spécifier RPC_C_AUTHN_WINNT ou RPC_C_AUTHN_DEFAULT pour ce paramètre.
[in, optional] authIdentity
Pointeur vers une structure SEC_WINNT_AUTH_IDENTITY_W qui contient les informations d’identification d’authentification et d’autorisation pour accéder au moteur de filtre. Ce paramètre est ignoré lorsque la fonction FwpmEngineOpen0 est appelée à partir d’un pilote de légende. Les pilotes de légende doivent définir ce paramètre sur NULL.
[in, optional] session
Pointeur vers une structure FWPM_SESSION0 qui définit des paramètres spécifiques à la session en cours d’ouverture. Ce pointeur est facultatif et peut être NULL.
[out] engineHandle
Pointeur vers une variable qui reçoit un handle pour la session ouverte vers le moteur de filtre.
Valeur de retour
La fonction FwpmEngineOpen0 retourne l’un des codes NTSTATUS suivants.
| Retourner le code | Description |
|---|---|
| STATUS_SUCCESS | Une session sur le moteur de filtre a été ouverte avec succès. La variable pointée par le paramètre engineHandle contient un handle pour la session ouverte. |
| autres codes NTSTATUS | Une erreur s’est produite. |
Remarques
Un pilote de légende appelle la fonction FwpmEngineOpen0 pour ouvrir une session au moteur de filtre. Un handle vers une session ouverte au moteur de filtre est un paramètre requis pour la plupart des fonctions de gestion de la plateforme de filtrage Windows .
Les pilotes de légende n’ont normalement pas besoin d’ouvrir une session sur le moteur de filtre, car les pilotes de légende n’appellent généralement aucune des fonctions de plateforme de filtrage Windows de gestion.
Pour qu’un pilote de légende ouvre correctement une session sur le moteur de filtre, le moteur de filtre doit être en cours d’exécution au moment où le pilote de légende appelle la fonction FwpmEngineOpen0. Un pilote de légende peut appeler la fonction FwpmBfeStateGet0 pour obtenir l’état actuel du moteur de filtre. Avant d’appeler FwpmBfeStateGet0, le pilote de légende doit appeler la fonction FwpmBfeStateSubscribeChanges0 pour inscrire une fonction de rappel qui sera appelée chaque fois qu’il existe une modification de l’état du moteur de filtre.
Une fois qu’un pilote de légende a terminé d’accéder au moteur de filtre, il appelle la fonction FwpmEngineClose0 pour fermer la session ouverte au moteur de filtre.
FwpmEngineOpen0 est une version spécifique de FwpmEngineOpen. Pour plus d’informations, consultez PAM Version-Independent noms et ciblage de versions spécifiques de Windows.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows Vista. |
| plateforme cible | Universel |
| d’en-tête | fwpmk.h (include Fwpmk.h) |
| bibliothèque | Fwpkclnt.lib |
| IRQL | PASSIVE_LEVEL |