Método INetFwOpenPorts::Add (netfw.h)
[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.]
Abre uma nova porta e a adiciona à coleção.
Sintaxe
HRESULT Add(
[in] INetFwOpenPort *port
);
Parâmetros
[in] port
Porta a ser adicionada à coleção.
Retornar valor
C++
| Código de retorno | Descrição |
|---|---|
|
A operação foi anulada devido a problemas de permissões. |
|
O método falhou porque um parâmetro não era válido. |
|
O método não pôde alocar a memória necessária. |
|
O método falhou porque o objeto já está na coleção. |
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 |
|---|---|
|
A operação foi anulada devido a problemas de permissões. |
|
O método falhou porque um parâmetro não era válido. |
|
O método não pôde alocar a memória necessária. |
|
O método falhou porque o objeto já está na coleção. |
Comentários
Se a porta já estiver aberta, as configurações existentes serão substituídas.
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 |