Método INetFwOpenPorts::Item (netfw.h)

Artigo
02/29/2024

[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.]

Retorna a porta especificada se ela estiver na coleção.

Sintaxe

HRESULT Item(
  [in]  LONG               portNumber,
  [in]  NET_FW_IP_PROTOCOL ipProtocol,
  [out] INetFwOpenPort     **openPort
);

Parâmetros

[in] portNumber

Número da porta a ser localizado.

[in] ipProtocol

Protocolo da porta a ser encontrada por tipo NET_FW_IP_PROTOCOL.

[out] openPort

Referência ao objeto INetFwOpenPort retornado.

Retornar valor

C++

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.

Erro	Descrição
E_ACCESSDENIED	A operação foi anulada devido a problemas de permissões.
E_INVALIDARG	O método falhou devido a um parâmetro inválido.
E_OUTOFMEMORY	O método não pôde alocar a memória necessária.
E_POINTER	O método falhou devido a um ponteiro inválido.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	O item solicitado não existe.

VB

Referência ao objeto INetFwOpenPort retornado.

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

INetFwOpenPort

INetFwOpenPorts

NET_FW_IP_PROTOCOL

Compartilhar via