Compartir a través de

Función FwpmEngineSetOption0 (fwpmu.h)

  • Artículo

La función FwpmEngineSetOption0 cambia la configuración del motor de filtro.

Sintaxis

DWORD FwpmEngineSetOption0(
  [in] HANDLE             engineHandle,
  [in] FWPM_ENGINE_OPTION option,
  [in] const FWP_VALUE0   *newValue
);

Parámetros

[in] engineHandle

Tipo: HANDLE

Identificador de una sesión abierta en el motor de filtro. Llame a FwpmEngineOpen0 para abrir una sesión en el motor de filtro.

[in] option

Tipo: FWPM_ENGINE_OPTION

Opción que se va a establecer.

[in] newValue

Tipo: FWP_VALUE0*

Nuevo valor de opción. El tipo de datos contenido en el parámetro newValue debe ser FWP_UINT32.

Cuando la opción es FWPM_ENGINE_COLLECT_NET_EVENTS, newValue debe ser una de las siguientes.

Valor Significado
0
 No recopile eventos de red.
1
 Recopilar eventos de red. Esta es la configuración predeterminada.
 

Cuando la opción es FWPM_ENGINE_NET_EVENT_MATCH_ANY_KEYWORDS, newValue debe ser 0 (cero) o una combinación bit a bit de los valores siguientes.

Nota Si newValue es 0, la colección de eventos de multidifusión entrante y de difusión está deshabilitada. Esta es la configuración predeterminada.
 
Valor Significado
FWPM_NET_EVENT_KEYWORD_INBOUND_MCAST
1
 Recopilar eventos de red de multidifusión entrantes.
FWPM_NET_EVENT_KEYWORD_INBOUND_BCAST
2
 Recopilar eventos de red de difusión de entrada.
 

Cuando la opción es FWPM_ENGINE_PACKET_QUEUING (disponible solo en Windows 8 y Windows Server 2012), newValue debe ser una de las siguientes.

Valor Significado
FWPM_ENGINE_OPTION_PACKET_QUEUE_NONE
0
 No habilite la puesta en cola de paquetes.
FWPM_ENGINE_OPTION_PACKET_QUEUE_INBOUND
1
 Habilite la puesta en cola de paquetes entrantes.
FWPM_ENGINE_OPTION_PACKET_QUEUE_OUTBOUND
2
 Habilite la puesta en cola de paquetes salientes.
 

Cuando la opción es FWPM_ENGINE_MONITOR_IPSEC_CONNECTIONS (disponible solo en Windows 8 y Windows Server 2012), newValue debe ser lo siguiente. (FwpmEngineSetOption0 se puede usar para habilitar las conexiones, pero se producirá un error FWP_E_STILL_ON ERROR al intentar deshabilitarla).

Valor Significado
1
 Se habilitará la característica Supervisión de conexiones IPsec. Los nuevos eventos de conexión IPsec se registrarán, así como las notificaciones enviadas.
 

Cuando la opción es FWPM_ENGINE_TXN_WATCHDOG_TIMEOUT_IN_MSEC (disponible solo en Windows 8 y Windows Server 2012), newValue debe ser el tiempo en milisegundos que especifica la duración máxima de una sola transacción DE PMA. Las transacciones que tardan más de esta duración desencadenarán un evento de guardián.

La opción FWPM_ENGINE_NAME_CACHE está reservada para uso interno.

Valor devuelto

Tipo: DWORD

Código o valor devuelto Descripción
ERROR_SUCCESS
0
 La opción se estableció correctamente.
código de error FWP_E_*
0x80320001: 0x80320039
 Error específico de la Plataforma de filtrado de Windows (PMA). Consulte Códigos de error de PMA para obtener más información.
RPC_* código de error*
0x80010001: 0x80010122
 Error al comunicarse con el motor de firewall remoto o local.

Comentarios

No se puede llamar a esta función desde dentro de una transacción. Se producirá un error con FWP_E_TXN_IN_PROGRESS. Consulte Administración de objetos para obtener más información sobre las transacciones.

No se puede llamar a esta función desde dentro de una sesión dinámica. Se producirá un error con FWP_E_DYNAMIC_SESSION_IN_PROGRESS. Consulte Administración de objetos para obtener más información sobre las sesiones.

El autor de la llamada necesita FWPM_ACTRL_WRITE acceso al motor de filtro. Consulte Access Control para obtener más información.

La configuración predeterminada para la recopilación de eventos de red es la siguiente:

  • Se recopilan todos los eventos de salida (unidifusión, multidifusión y difusión).
  • Entrante, solo se recopilan eventos de unidifusión.
La configuración de recopilación de eventos de red persiste en los reinicios.

Para recopilar eventos de red de difusión entrante o multidifusión,

  1. Llame a FwpmEngineSetOption0 con la opción establecida en FWPM_ENGINE_COLLECT_NET_EVENTS y newValue establecido en 1.
  2. Llame a FwpmEngineSetOption0 con la opción establecida en FWPM_ENGINE_NET_EVENT_MATCH_ANY_KEYWORDS y el parámetro newValue establecido en FWPM_NET_EVENT_KEYWORD_INBOUND_MCAST o FWPM_NET_EVENT_KEYWORD_INBOUND_BCAST.
Para dejar de recopilar eventos de red de difusión entrante o multidifusión,
  • Llame a FwpmEngineSetOption0 con la opción establecida en FWPM_ENGINE_NET_EVENT_MATCH_ANY_KEYWORDS y el parámetro newValue establecido en 0 (cero).
Deshabilitar y volver a habilitar la recopilación de eventos de red (FWPM_ENGINE_COLLECT_NET_EVENTS) no restablece la colección de eventos de difusión entrante y multidifusión.

FwpmEngineSetOption0 es una implementación específica de FwpmEngineSetOption. Para obtener más información, consulte NOMBRES de PMA Version-Independent y versiones específicas de destino de Windows .

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado fwpmu.h
Library Fwpuclnt.lib
Archivo DLL Fwpuclnt.dll

Consulte también

FWPM_ENGINE_OPTION

FWP_VALUE0

FwpmEngineGetOption0