Fonction FwpmDynamicKeywordSubscribe0 (fwpmu.h)
Demande la remise de notifications concernant les modifications apportées à des objets d’adresse de mot clé dynamique (FW_DYNAMIC_KEYWORD_ADDRESS0). En fonction de l’indicateur transmis, les notifications peuvent être déclenchées uniquement pour un sous-ensemble d’adresses.
Pour plus d’informations et des exemples de code, consultez Mots clés dynamiques de pare-feu.
Syntaxe
DWORD FwpmDynamicKeywordSubscribe0(
DWORD flags,
FWPM_DYNAMIC_KEYWORD_CALLBACK0 callback,
void *context,
HANDLE *subscriptionHandle
);
Paramètres
flags
Type : _In_ DWORD
Les indicateurs suivants sont définis dans fwpmu.h.
FWPM_NOTIFY_ADDRESSES_AUTO_RESOLVE indique que les notifications seront remises uniquement pour les objets dont l’indicateur FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE est défini.
FWPM_NOTIFY_ADDRESSES_NON_AUTO_RESOLVE indique que les notifications seront remises uniquement pour les objets qui n’ont pas l’indicateur FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE défini.
FWPM_NOTIFY_ADDRESSES_AUTO_RESOLVE indique que des notifications seront remises pour tous les objets d’adresse mot clé dynamiques.
callback
Type : _In_ FWPM_DYNAMIC_KEYWORD_CALLBACK0
Pointeur vers une fonction de rappel que vous implémentez, qui sera appelée lorsqu’une notification est prête à être remise.
context
Type : _In_opt_ void*
Pointeur de contexte facultatif. Ce pointeur est passé à la fonction de rappel.
subscriptionHandle
Type : _Out_ HANDLE*
Adresse d’un handle, qui est rempli avec un handle pour l’abonnement nouvellement créé.
Valeur retournée
Type : DWORD
Si la fonction réussit, elle retourne ERROR_SUCCESS. Sinon, elle retourne l’une des valeurs suivantes.
| Valeur retournée | Description |
|---|---|
| ERROR_INVALID_PARAMETER | La valeur des indicateurs est zéro. |
Remarques
Les notifications de résolution automatique des adresses de mot clé dynamiques sont remises lorsqu’un objet est ajouté ou supprimé.
Les notifications pour les adresses de mot clé dynamiques non-AutoResolve sont remises lorsqu’un objet est ajouté, supprimé ou mis à jour.
Aucune donnée n’est fournie à la fonction de rappel. Vous pouvez utiliser l’API Énumération si vous avez besoin d’informations sur ce qui a changé sur le système.
Vous êtes responsable de la fermeture du handle lorsque vous n’avez plus besoin d’un abonnement. Pour ce faire, appelez la fonction FwpmDynamicKeywordUnsubscribe0 .
Votre implémentation de FWPM_DYNAMIC_KEYWORD_CALLBACK0 doit réagir rapidement aux modifications apportées aux mot clé d’adresses dynamiques, car elle est planifiée sur un thread ThreadPool et peut affecter d’autres opérations d’attente.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 10 Build 20348 |
| Serveur minimal pris en charge | Windows 10 Build 20348 |
| Plateforme cible | Windows |
| En-tête | fwpmu.h |
| Bibliothèque | Fwpuclnt.lib |
| DLL | Fwpuclnt.dll |