FwpsvSwitchEventsSubscribe0, fonction (fwpsk.h)

  • Article

La fonction FwpsvSwitchEventsSubscribe0 inscrit les points d’entrée de rappel pour les événements de couche de commutateur virtuel tels que la création et la suppression de ports virtuels.

RemarqueFwpsvSwitchEventsSubscribe0 est une version spécifique de FwpsvSwitchEventsSubscribe. Pour plus d’informations , consultez WFP Version-Independent Names and Targeting Specific Versions of Windows .

 

Syntaxe

NTSTATUS FwpsvSwitchEventsSubscribe0(
  const GUID                              *providerGuid,
  void                                    *notifyContext,
  UINT32                                  flags,
  void                                    *reserved,
  const FWPS_VSWITCH_EVENT_DISPATCH_TABLE *eventDispatchTable,
  UINT32                                  *subscriptionId
);

Paramètres

providerGuid

GUID du fournisseur.

notifyContext

Pointeur facultatif vers un contexte fourni par un pilote de légende. Les fonctions de notification d’événement retransdent ce paramètre au pilote.

flags

Réservé. Définit la valeur zéro.

reserved

Réservé. Définit la valeur zéro.

eventDispatchTable

Pointeur vers une structure de FWPS_VSWITCH_EVENT_DISPATCH_TABLE qui définit les points d’entrée de rappel pour les événements de couche de commutateur virtuel.

subscriptionId

Pointeur vers une variable qui contient un identificateur unique que PAM affecte à l’abonnement. L’appelant doit retourner l’identificateur d’abonnement à PAM avec la fonction FwpsvSwitchEventsUnsubscribe0 .

Valeur retournée

La fonction FwpsvSwitchEventsSubscribe0 retourne l’un des codes NTSTATUS suivants.

Code de retour Description
STATUS_SUCCESS
 Un handle de la demande de classification a été retourné avec succès. La variable vers laquelle pointe le paramètre classifyHandle contient le handle de la demande de classification.
Autres codes status
 Une erreur est survenue.

Remarques

Un pilote de légende appelle la fonction FwpsvSwitchEventsSubscribe0 pour inscrire les points d’entrée de rappel pour les événements de couche de commutateur virtuel.

Les points d’entrée des fonctions de notification de rappel sont spécifiés dans et FWPS_VSWITCH_EVENT_DISPATCH_TABLE0 structure.

Le pilote de légende doit ultérieurement appeler FwpsvSwitchEventsUnsubscribe0 pour libérer les ressources système.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows 8.
Plateforme cible Universal
En-tête fwpsk.h (include Fwpsk.h)
Bibliothèque Fwpkclnt.lib
IRQL <= PASSIVE_LEVEL

Voir aussi

FWPS_VSWITCH_EVENT_DISPATCH_TABLE0

FwpsvSwitchEventsUnsubscribe0