Partager via

PFN_FWADDDYNAMICKEYWORDADDRESS0 fonction de rappel (netfw.h)

  • Article

Type de pointeur de fonction du point d’entrée dans le service que vous appelez pour ajouter l’adresse de mot clé dynamique spécifiée.

Notes

Un type de pointeur pour cette fonction gratuite est publié via NetFw.h, mais aucune bibliothèque de liens statiques n’est publiée. Utilisez le modèleGetProcAddressLoadLibraryExW/ pour appeler cette fonction.

Lorsque vous appelez GetProcAddress, passez un handle au module firewallapi.dll et transmettez FWAddDynamicKeywordAddress0 comme argument lpProcName .

Pour plus d’informations et des exemples de code, consultez Mots clés dynamiques de pare-feu.

Syntaxe

PFN_FWADDDYNAMICKEYWORDADDRESS0 PfnFwadddynamickeywordaddress0;

DWORD PfnFwadddynamickeywordaddress0(
  const PFW_DYNAMIC_KEYWORD_ADDRESS0 dynamicKeywordAddress
)
{...}

Paramètres

dynamicKeywordAddress

Type : const PFW_DYNAMIC_KEYWORD_ADDRESS0

Pointeur vers un objet d’adresse mot clé dynamique constant (rempli).

Valeur retournée

Type : DWORD

Si la fonction réussit (l’objet a été créé et ajouté), elle retourne ERROR_SUCCESS. Sinon, elle retourne l’une des valeurs suivantes.

Valeur retournée Description
ERROR_ACCESS_DENIED L’appelant ne dispose pas des autorisations appropriées pour créer cet objet.
ERROR_ALREADY_EXISTS Un objet avec l’ID spécifié existe déjà sur le système.
ERROR_INVALID_PARAMETER FW_DYNAMIC_KEYWORD_ADDRESS0 non valide. Consultez Les remarques pour une utilisation valide.

Notes

  • Si l’indicateur FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE est défini, alors :
    • les adresses doivent être NULL, et
    • le champ mot clé doit être une chaîne qui peut être résolue, c’est-à-dire un nom de domaine complet ou un nom d’hôte.
  • Si l’indicateur FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVEn’est pas défini, le champ adresses doit être une liste de jetons d’adresse IP séparés par des virgules. Les jetons peuvent être des adresses IP, des plages ou des sous-réseaux individuels. Les formats de jeton valides sont les suivants :
    • Une adresse IPv4 valide (par exemple, 10.0.0.10)
    • Une adresse IPv6 valide (par exemple, 2620:1ec:c11::200)
    • Plage d’adresses IPv4 au format <adresse de<> fin de début>, sans espaces inclus (par exemple, 10.0.0.0-10.0.0.0.255)
    • Plage d’adresses IPv6 au format <adresse de fin de début>><, sans espaces inclus (par exemple, 2001:db8:abcd:12::-2001:db8:abcd:12:ffff:ffff:ffff:ffff)
    • Sous-réseau IPv4 valide spécifié à l’aide de la notation de préfixe réseau (par exemple, 10.0.0.0/24)
    • Sous-réseau IPv6 valide spécifié à l’aide de la notation de longueur de préfixe (par exemple, 2001:db8:abcd:0012::0/64)
  • Une adresse de mot clé dynamique persiste entre les redémarrages. Pour les objets AutoResolved , les adresses ne sont pas conservées entre les cycles de démarrage et doivent être réévaluées au cours du cycle de démarrage suivant.

Spécifications

   
Client minimal pris en charge Windows 10 Build 20348
Serveur minimal pris en charge Windows 10 Build 20348
Plateforme cible Windows
En-tête netfw.h
DLL firewallapi.dll

Voir aussi