Compartir a través de

Método INetFwMgr::IsIcmpTypeAllowed (netfw.h)

  • Artículo

[La API de Firewall de Windows está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. Para Windows Vista y versiones posteriores, se recomienda el uso del Firewall de Windows con la API de seguridad avanzada.

Determina si se permite el tipo ICMP especificado.

Sintaxis

HRESULT IsIcmpTypeAllowed(
  [in]  NET_FW_IP_VERSION ipVersion,
  [in]  BSTR              localAddress,
  [in]  BYTE              type,
  [out] VARIANT           *allowed,
  [out] VARIANT           *restricted
);

Parámetros

[in] ipVersion

Versión IP del tráfico. No se puede NET_FW_IP_VERSION_ANY.

Versión IP del tráfico. No se puede NET_FW_IP_VERSION_ANY.

[in] localAddress

Una dirección IPv4 decimal con puntos o una dirección hexadecimal IPv6 que especifica la dirección local del tráfico. Normalmente, esta es la dirección que se pasa al enlace. Si localAddress es NULL, la función determina si se permite el puerto para todas las interfaces.

[in] type

Tipo ICMP. Para obtener una lista de los posibles tipos ICMP, vea Números de tipo ICMP.

[out] allowed

Indica por un valor de VARIANT_TRUE o VARIANT_FALSE si se permite el puerto para al menos algunas interfaces locales y direcciones remotas.

[out] restricted

Indica por un valor de VARIANT_TRUE o VARIANT_FALSE si algunas interfaces locales o direcciones remotas están bloqueadas para este puerto. Por ejemplo, si el puerto está restringido solo a la subred local.

Valor devuelto

C++

Código devuelto Descripción
E_ACCESSDENIED
 La operación se detuvo debido a problemas de permisos.
E_INVALIDARG
 Error en el método porque un parámetro no era válido.
E_OUTOFMEMORY
 El método no pudo asignar la memoria necesaria.
E_POINTER
 Error en el método porque un puntero no era válido.
 

VB

Si el método se ejecuta correctamente, el valor devuelto es S_OK.

Si se produce un error en el método, el valor devuelto es uno de los siguientes códigos de error.

Código devuelto Descripción
E_ACCESSDENIED
 La operación se detuvo debido a problemas de permisos.
E_INVALIDARG
 Error en el método porque un parámetro no era válido.
E_OUTOFMEMORY
 El método no pudo asignar la memoria necesaria.
E_POINTER
 Error en el método porque un puntero no era válido.

Comentarios

El método INetFwPolicy2::IsRuleGroupEnabled se recomienda generalmente en lugar de este método.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 con SP1 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado netfw.h
Archivo DLL FirewallAPI.dll; Hnetcfg.dll en Windows XP con SP2

Consulte también

INetFwMgr

NET_FW_IP_VERSION