Función FwpmEngineGetOption0 (fwpmk.h)

  • Artículo

La función FwpmEngineGetOption0 recupera una opción de motor de filtro.

Sintaxis

NTSTATUS FwpmEngineGetOption0(
  [in]  HANDLE             engineHandle,
  [in]  FWPM_ENGINE_OPTION option,
  [out] FWP_VALUE0         **value
);

Parámetros

[in] engineHandle

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

Opción que se va a recuperar.

[out] value

Valor de opción. El tipo de datos contenido en el parámetro value será FWP_UINT32.

Si la opción es FWPM_ENGINE_COLLECT_NET_EVENTS, el valor será uno de los siguientes.

Valor Significado
0 Los eventos de red no se recopilan.
1 Se recopilan eventos de red.

Si opción es FWPM_ENGINE_NET_EVENT_MATCH_ANY_KEYWORDS, valor será una combinación bit a bit de los valores siguientes.

Valor Significado
FWPM_NET_EVENT_KEYWORD_INBOUND_MCAST (1) Se recopilan eventos de red de multidifusión entrantes.
FWPM_NET_EVENT_KEYWORD_INBOUND_BCAST (2) Los eventos de red de difusión de entrada no se recopilan.

Si opción es FWPM_ENGINE_PACKET_QUEUING (disponible solo en Windows 8 y Windows Server 2012), valor será uno de los siguientes.

Valor Significado
FWPM_ENGINE_OPTION_PACKET_QUEUE_NONE (0) No se habilita la puesta en cola de paquetes.
FWPM_ENGINE_OPTION_PACKET_QUEUE_INBOUND (1) La puesta en cola de paquetes entrantes está habilitada.
FWPM_ENGINE_OPTION_PACKET_QUEUE_OUTBOUND (2) La puesta en cola de paquetes salientes está habilitada.

Si opción es FWPM_ENGINE_MONITOR_IPSEC_CONNECTIONS (disponible solo en Windows 8 y Windows Server 2012), valor será uno de los siguientes.

Valor Significado
0 La característica Supervisión de conexiones IPsec está deshabilitada. No se registran eventos o notificaciones de conexión IPsec.
1 La característica Supervisión de conexiones IPsec está habilitada. Se registran nuevos eventos y notificaciones de conexión IPsec.

Si opción es FWPM_ENGINE_TXN_WATCHDOG_TIMEOUT_IN_MSEC (disponible solo en Windows 8 y Windows Server 2012), valor 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 guardián.

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

Valor devuelto

Código y valor devueltos Descripción
ERROR_SUCCESS 0 La opción se recuperó correctamente.
0x80320001 de código de error FWP_E_*: 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_* 0x80010001 de código de error: 0x80010122 Error al comunicarse con el motor de firewall remoto o local.
otros códigos NTSTATUS Error.

Observaciones

El autor de la llamada debe liberar el objeto devuelto por una llamada a FwpmFreeMemory0.

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

fwpmEngineGetOption0 es una implementación específica de FwpmEngineGetOption. Consulta nombres Version-Independent DEL PMA y destinatarios de versiones específicas de Windows para obtener más información.

Requisitos

Requisito Valor
cliente mínimo admitido Disponible a partir de Windows Vista.
de la plataforma de destino de Universal
encabezado de fwpmk.h
biblioteca de fwpkclnt.lib
irQL <= PASSIVE_LEVEL

Consulte también