Compartir a través de

Función FwpmDynamicKeywordSubscribe0 (fwpmu.h)

  • Artículo

Solicita la entrega de notificaciones con respecto a los cambios en determinados objetos de dirección de palabra clave dinámica (FW_DYNAMIC_KEYWORD_ADDRESS0). En función de la marca pasada, las notificaciones solo se pueden generar para un subconjunto de las direcciones.

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

Sintaxis

DWORD FwpmDynamicKeywordSubscribe0(
  DWORD                          flags,
  FWPM_DYNAMIC_KEYWORD_CALLBACK0 callback,
  void                           *context,
  HANDLE                         *subscriptionHandle
);

Parámetros

flags

Tipo: _In_ DWORD

Las marcas siguientes se definen en fwpmu.h.

FWPM_NOTIFY_ADDRESSES_AUTO_RESOLVE indica que las notificaciones solo se entregarán para los objetos que tienen establecida la marca FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE .

FWPM_NOTIFY_ADDRESSES_NON_AUTO_RESOLVE indica que las notificaciones solo se entregarán para los objetos que no tienen establecida la marca FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE .

FWPM_NOTIFY_ADDRESSES_AUTO_RESOLVE indica que las notificaciones se entregarán para todos los objetos de dirección de palabra clave dinámica.

callback

Tipo: _In_ FWPM_DYNAMIC_KEYWORD_CALLBACK0

Puntero a una función de devolución de llamada que implemente, que se invocará cuando una notificación esté lista para su entrega.

context

Tipo: _In_opt_ void*

Puntero de contexto opcional. Este puntero se pasa a la función de devolución de llamada.

subscriptionHandle

Tipo: _Out_ HANDLE*

La dirección de un identificador, que se rellena con un identificador para la suscripción recién creada.

Valor devuelto

Tipo: DWORD

Si la función se realiza correctamente, devuelve ERROR_SUCCESS. De lo contrario, devuelve uno de los valores siguientes.

Valor devuelto Descripción
ERROR_INVALID_PARAMETER El valor de las marcas es cero.

Comentarios

Las notificaciones para las direcciones de palabras clave dinámicas de AutoResolve se entregan cuando se agrega o elimina un objeto.

Las notificaciones de direcciones de palabras clave dinámicas que no son AutoResolve se entregan cuando se agrega, elimina o actualiza un objeto.

No se proporciona ningún dato a la función de devolución de llamada. Puede usar la API de enumeración si necesita información sobre lo que ha cambiado en el sistema.

Usted es responsable de cerrar el identificador cuando ya no necesita suscripción. Debe hacerlo llamando a la función FwpmDynamicKeywordUnsubscribe0 .

La implementación de FWPM_DYNAMIC_KEYWORD_CALLBACK0 debe reaccionar rápidamente a los cambios en los objetos de dirección de palabras clave dinámicas, ya que está programado en un subproceso threadPool y podría afectar a otras operaciones de espera.

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 fwpmu.h
Library Fwpuclnt.lib
Archivo DLL Fwpuclnt.dll

Consulte también