Compartilhar via

Método INetConnection::GetProperties (netcon.h)

  • Artigo

[O Firewall de Conexão com a Internet pode estar alterado ou indisponível em versões subsequentes. Em vez disso, use a API de Firewall do Windows.]

O método GetProperties recupera uma estrutura que contém as propriedades dessa conexão de rede.

Sintaxe

HRESULT GetProperties(
  [out] NETCON_PROPERTIES **ppProps
);

Parâmetros

[out] ppProps

Ponteiro para um ponteiro que, no retorno bem-sucedido, aponta para uma estrutura NETCON_PROPERTIES que contém as propriedades dessa conexão de rede.

Retornar valor

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_ABORT
 A operação foi anulada.
E_FAIL
 Ocorreu um erro não especificado.
E_INVALIDARG
 Um dos parâmetros é inválido.
E_NOINTERFACE
 Não há suporte para uma interface especificada.
E_NOTIMPL
 Um método especificado não é implementado.
E_OUTOFMEMORY
 O método não pôde alocar a memória necessária.
E_POINTER
 Um ponteiro passado como um parâmetro não é válido.
E_UNEXPECTED
 O método falhou por motivos desconhecidos.

Comentários

O aplicativo de chamada deve liberar a memória ocupada pela estrutura NETCON_PROPERTIES retornada por GetProperties. Libere a memória chamando a função NcFreeNetconProperties . Essa função é definida no NetCon.h e é exportada por NetShell.dll.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho netcon.h
DLL Hnetcfg.dll

Confira também

INetConnection

Interfaces de Firewall de Conexão com a Internet e Compartilhamento de Conexão com a Internet

Referência de Firewall de Conexão com a Internet e Compartilhamento de Conexão com a Internet