Compartilhar via


Método INetFwAuthorizedApplications::Remove (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 Remove remove um aplicativo da coleção.

Sintaxe

HRESULT Remove(
  [in] BSTR imageFileName
);

Parâmetros

[in] imageFileName

Nome do aplicativo a ser removido.

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

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

Comentários

O parâmetro imageFileName deve ser um caminho totalmente qualificado e pode conter variáveis de ambiente.

Se o aplicativo não existir na coleção, o método Remove não terá efeito.

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

INetFwAuthorizedApplications