Compartir a través de

PFN_FWADDDYNAMICKEYWORDADDRESS0 función de devolución de llamada (netfw.h)

  • Artículo

Tipo de puntero de función del punto de entrada en el servicio al que se llama para agregar la dirección de palabra clave dinámica especificada.

Nota:

Un tipo de puntero para esta función gratuita se publica a través NetFw.hde , pero no se publica una biblioteca de vínculos estáticos. Use el patrónGetProcAddressloadLibraryExW/ para llamar a esta función.

Al llamar a GetProcAddress, pase un identificador al módulo defirewallapi.dll y pase FWAddDynamicKeywordAddress0 como argumento lpProcName .

Para obtener más información y ejemplos de código, consulte Palabras clave dinámicas del firewall.

Sintaxis

PFN_FWADDDYNAMICKEYWORDADDRESS0 PfnFwadddynamickeywordaddress0;

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

Parámetros

dynamicKeywordAddress

Tipo: const PFW_DYNAMIC_KEYWORD_ADDRESS0

Puntero a un objeto de dirección de palabra clave dinámica constante (rellenado).

Valor devuelto

Tipo: DWORD

Si la función se realiza correctamente (el objeto se creó y agregó correctamente), devuelve ERROR_SUCCESS. De lo contrario, devuelve uno de los valores siguientes.

Valor devuelto Descripción
ERROR_ACCESS_DENIED El autor de la llamada no tiene los permisos adecuados para crear este objeto.
ERROR_ALREADY_EXISTS Ya existe un objeto con el identificador especificado en el sistema.
ERROR_INVALID_PARAMETER FW_DYNAMIC_KEYWORD_ADDRESS0 no válidos. Vea Comentarios para obtener un uso válido.

Comentarios

  • Si se establece la marca FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE , haga lo siguiente:
    • las direcciones deben ser NULL y
    • el campo de palabra clave debe ser una cadena que se pueda resolver; es decir, un FQDN o un nombre de host.
  • Si no se establece la marca de FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE, el campo direcciones debe ser una lista separada por comas de tokens de dirección IP. Los tokens pueden ser direcciones IP individuales, intervalos o subredes. Los formatos de token válidos incluyen:
    • Una dirección IPv4 válida (por ejemplo, 10.0.0.10)
    • Una dirección IPv6 válida (por ejemplo, 2620:1ec:c11::200)
    • Intervalo de direcciones IPv4 con el formato <dirección> de inicio de dirección-extremo><, sin espacios incluidos (por ejemplo, 10.0.0.0-10.0.0.255)
    • Intervalo de direcciones IPv6 con el formato <dirección> de inicio de dirección-end><, sin espacios incluidos (por ejemplo, 2001:db8:abcd:12::-2001:db8:abcd:12:ffff:ffff:ffff:ffff:ffff:ffff)
    • Una subred IPv4 válida especificada mediante la notación de prefijo de red (por ejemplo, 10.0.0.0/24)
    • Una subred IPv6 válida especificada mediante la notación de longitud de prefijo (por ejemplo, 2001:db8:abcd:0012::0/64)
  • Una dirección de palabra clave dinámica persiste en los reinicios. En el caso de los objetos AutoResolved , las direcciones no se conservan en los ciclos de arranque y se deben volver a evaluar durante el siguiente ciclo de arranque.

Requisitos

   
Cliente mínimo compatible Compilación 20348 de Windows 10
Servidor mínimo compatible Compilación 20348 de Windows 10
Plataforma de destino Windows
Encabezado netfw.h
Archivo DLL firewallapi.dll

Consulte también