Método INetFwAuthorizedApplications::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.]
O método Add adiciona um novo aplicativo à coleção.
Sintaxe
HRESULT Add(
[in] INetFwAuthorizedApplication *app
);
Parâmetros
[in] app
| C++ | Aplicativo a ser adicionado à coleção por meio de um objeto INetFWAuthorizedApplication . |
| VB | Aplicativo a ser adicionado à coleção por meio de um objeto INetFWAuthorizedApplication . |
Retornar valor
C++
Se o método tiver êxito, 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. |
VB
Se o método tiver êxito, 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 já existir um aplicativo com o mesmo caminho, 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 |