Compartilhar via


Método INetSharingManager::get_NetConnectionProps (netcon.h)

[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 get_NetConnectionProps recupera uma interface de propriedades para a conexão especificada.

Sintaxe

HRESULT get_NetConnectionProps(
  [in]  INetConnection      *pNetConnection,
  [out] INetConnectionProps **ppProps
);

Parâmetros

[in] pNetConnection

Ponteiro para uma interface INetConnection para a conexão para a qual recuperar a interface de propriedades.

[out] ppProps

Ponteiro para um ponteiro de interface que, no retorno bem-sucedido, aponta para uma interface INetConnectionProps para a conexão.

Retornar valor

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

Nem todas as conexões podem ser configuradas para compartilhamento. Recupere as propriedades da conexão para verificar se a conexão pode ser compartilhada antes de chamar INetSharingManager::get_INetSharingConfigurationForINetConnection.

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

INetSharingManager

INetSharingManager::get_INetSharingConfigurationForINetConnection

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