Compartilhar via

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

  • Artigo

[A API do Firewall do Windows está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Para o Windows Vista e posterior, é recomendável usar o Firewall do Windows com a API de Segurança Avançada.]

Determina se o tipo ICMP especificado é permitido.

Sintaxe

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

Parâmetros

[in] ipVersion

Versão ip do tráfego. Isso não pode ser NET_FW_IP_VERSION_ANY.

Versão ip do tráfego. Isso não pode ser NET_FW_IP_VERSION_ANY.

[in] localAddress

Um endereço IPv4 decimal pontilhado ou um endereço hex hex IPv6 especificando o endereço local do tráfego. Normalmente, esse é o endereço passado para associar. Se localAddress for NULL, a função determinará se a porta é permitida para todas as interfaces.

[in] type

Tipo ICMP. Para obter uma lista de possíveis tipos ICMP, consulte Números de tipo ICMP.

[out] allowed

Indica por um valor de VARIANT_TRUE ou VARIANT_FALSE se a porta é permitida para pelo menos algumas interfaces locais e endereços remotos.

[out] restricted

Indica por um valor de VARIANT_TRUE ou VARIANT_FALSE se algumas interfaces locais ou endereços remotos estão bloqueados para essa porta. Por exemplo, se a porta for restrita somente à sub-rede local.

Retornar valor

C++

Código de retorno Descrição
E_ACCESSDENIED
 A operação foi interrompida devido a problemas de permissões.
E_INVALIDARG
 O método falhou porque um parâmetro não era válido.
E_OUTOFMEMORY
 O método não pôde alocar a memória necessária.
E_POINTER
 O método falhou porque um ponteiro não era válido.
 

VB

Se o método for bem-sucedido, o valor retornado será S_OK.

Se o método falhar, o valor retornado será um dos seguintes códigos de erro.

Código de retorno Descrição
E_ACCESSDENIED
 A operação foi interrompida devido a problemas de permissões.
E_INVALIDARG
 O método falhou porque um parâmetro não era válido.
E_OUTOFMEMORY
 O método não pôde alocar a memória necessária.
E_POINTER
 O método falhou porque um ponteiro não era válido.

Comentários

O método INetFwPolicy2::IsRuleGroupEnabled geralmente é recomendado no lugar desse método.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 com SP1 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho netfw.h
DLL FirewallAPI.dll; Hnetcfg.dll no Windows XP com SP2

Confira também

INetFwMgr

NET_FW_IP_VERSION