Partager via


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

Voir aussi