Compartilhar via


Método INetSharingConfiguration::EnableSharing (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 EnableSharing permite o compartilhamento nessa conexão.

Sintaxe

HRESULT EnableSharing(
  [in] SHARINGCONNECTIONTYPE Type
);

Parâmetros

[in] Type

Especifica se essa conexão é compartilhada publicamente ou privadamente.

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

Chamar esse método dispara a seguinte notificação:

%programname% está tentando habilitar o Compartilhamento de Conexão com a Internet na conexão de rede %connectionname%. Isso permitirá que outros computadores em sua rede se conectem à Internet por meio de uma conexão pública compartilhada. Deseja que %programname% habilite o Compartilhamento de Conexão com a Internet nessa conexão?

Se o aplicativo de chamada especificar que essa conexão é compartilhada publicamente, qualquer conexão compartilhada publicamente anterior será desabilitada automaticamente.

Uma conexão compartilhada publicamente tem automaticamente o Firewall de Conexão da Internet habilitado. As conexões compartilhadas privadas mantêm suas configurações existentes.

Use o método INetSharingManager::get_INetSharingConfigurationForINetConnection para obter uma interface INetSharingConfiguration para uma conexão específica.

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

INetSharingConfiguration

INetSharingConfiguration::D isableSharing

INetSharingConfiguration::get_SharingEnabled

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

SHARINGCONNECTIONTYPE