Compartir a través de

PFN_FWUPDATEDYNAMICKEYWORDADDRESS0 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 actualizar la dirección de palabra clave dinámica con el identificador de entrada.

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 firewallapi.dll y pase FWFreeDynamicKeywordAddressData0 como argumento lpProcName .

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

Sintaxis

PFN_FWUPDATEDYNAMICKEYWORDADDRESS0 PfnFwupdatedynamickeywordaddress0;

DWORD PfnFwupdatedynamickeywordaddress0(
  GUID dynamicKeywordAddressId,
  PCWSTR updatedAddresses,
  BOOL append
)
{...}

Parámetros

dynamicKeywordAddressId

Tipo: GUID

Identificador del objeto de dirección de palabra clave dinámica que se va a actualizar.

updatedAddresses

Tipo: PCWSTR

Lista separada por comas de direcciones IP, subredes o intervalos con los que actualizar el objeto.

append

Tipo: BOOL

Establézcalo en TRUE y el elemento updatedAddresses se anexará a la lista actual de direcciones del objeto. Establézcalo en FALSE y el elemento updatedAddresses reemplazará la lista actual del objeto de direcciones.

Valor devuelto

Tipo: DWORD

Si la función se realiza correctamente (el objeto se actualizó 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 operar en el objeto con el identificador especificado. Este error se produce cuando se llama a esta API en objetos que no son AutoResolve administrados por MDM.
ERROR_INVALID_PARAMETER Entre las condiciones de error comunes se incluyen: No existe ningún objeto con el identificador especificado; las direcciones tienen un formato no válido.

Comentarios

Si append es TRUE, las direcciones de entrada se anexarán a la lista actual de direcciones del objeto. Si el parámetro de entrada es un duplicado de una dirección ya establecida en el objeto , se descartará y se devolverá ERROR_SUCCESS .

El servicio de firewall trata una dirección como duplicado si la dirección es exactamente equivalente a un valor en el campo direcciones existentes de la dirección de palabra clave dinámica. Los valores duplicados se consideran en un elemento individual, por lo que una actualización con una lista de direcciones IP podría tener solo un subconjunto de entradas duplicadas descartadas. Por ejemplo, si el objeto de dirección de palabra clave dinámica contiene 127.0.0.0-127.0.0.255, se descartará cualquier entrada de 127.0.0.0-127.0.0.255 o 127.0.0.0/24 . Sin embargo, una entrada como 127.0.0.0-127.0.0.40 no se descartaría, ya que es un subconjunto y no un duplicado directo.

Si append es FALSE, la entrada sobrescribirá la lista actual del objeto de direcciones.

Los objetos que no son AutoResolve que se originaron en MDM darán lugar a ERROR_ACCESS_DENIED.

Los objetos que no son AutoResolve creados localmente (mediante la API o PowerShell) se actualizan a través de esta API.

Los objetos AutoResolve de cualquier origen se pueden actualizar a través de esta API.

Para borrar las direcciones de un objeto, pase NULL para el valor updatedAddresses .

El formato válido para el parámetro updatedAddresses es 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)
  • Un intervalo de direcciones IPv4 en la <dirección> de inicio de dirección><, sin espacios incluidos (por ejemplo, 10.0.0.0-10.0.0.0.255)
  • Un intervalo de direcciones IPv6 en el formato <dirección de inicio dirección-fin><>, sin espacios incluidos (por ejemplo, 2001:db8:abcd:12::-2001:db8:abcd:12: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 con la notación de longitud de prefijo (por ejemplo, 2001:db8:abcd:0012::0/64)

Requisitos

Requisito Value
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