Método INetFwPolicy::GetProfileByType (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.]

Recupera o perfil do tipo solicitado.

Sintaxe

HRESULT GetProfileByType(
  [in]       NET_FW_PROFILE_TYPE profileType,
  [out, ref] INetFwProfile       **profile
);

Parâmetros

[in] profileType

Tipo de perfil de NET_FW_PROFILE_TYPE.

[out, ref] profile

Perfil recuperado do tipo INetFwProfile.

Perfil recuperado do tipo INetFwProfile.

Retornar valor

C++

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.
E_POINTER
 O método falhou devido a um ponteiro invá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 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.

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

INetFwPolicy

INetFwProfile

NET_FW_PROFILE_TYPE