PFN_FWENUMDYNAMICKEYWORDADDRESSESBYTYPE0 fonction de rappel (netfw.h)

Article
02/29/2024

Type de pointeur de fonction du point d’entrée dans le service que vous appelez pour énumérer les adresses dynamiques mot clé par type. Vous pouvez demander un sous-ensemble particulier d’objets en fonction des indicateurs d’énumération transmis.

Notes

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

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

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

Syntaxe

PFN_FWENUMDYNAMICKEYWORDADDRESSESBYTYPE0 PfnFwenumdynamickeywordaddressesbytype0;

DWORD PfnFwenumdynamickeywordaddressesbytype0(
  DWORD flags,
  PFW_DYNAMIC_KEYWORD_ADDRESS_DATA0 *dynamicKeywordAddressData
)
{...}

Paramètres

flags

Type : DWORD

L’utilisation de la valeur FW_DYNAMIC_KEYWORD_ADDRESS_ENUM_FLAGS_AUTO_RESOLVE énumère tous les objets dont l’indicateur FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE est défini.

L’utilisation de la valeur FW_DYNAMIC_KEYWORD_ADDRESS_ENUM_FLAGS_NON_AUTO_RESOLVE énumère tous les objets dont l’indicateur FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE n’estpas défini.

L’utilisation de la valeur FW_DYNAMIC_KEYWORD_ADDRESS_ENUM_FLAGS_NON_AUTO_RESOLVE énumère tous les objets.

dynamicKeywordAddressData

Type : _Out_ PFW_DYNAMIC_KEYWORD_ADDRESS0*

Adresse d’un pointeur vers un objet d’adresse dynamique mot clé, qui contiendra une liste liée d’objets retournés. Vous devez libérer cette adresse en appelant FWFreeDynamicKeywordAddressData0.

Valeur retournée

Type : DWORD

Si la fonction réussit, elle retourne ERROR_SUCCESS. Sinon, il retourne l’une des valeurs suivantes.

Valeur retournée	Description
ERROR_INVALID_PARAMETER	Une valeur zéro a été passée pour le paramètre flags .

Remarques

Vous devez libérer l’adresse du premier objet retourné dans la liste (le chef de la liste) en appelant FWFreeDynamicKeywordAddressData0.

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	netfw.h
DLL	firewallapi.dll

Voir aussi

Mots clés dynamiques de pare-feu

Partager via