Método INetSharingConfiguration::get_SharingEnabled (netcon.h)

Artigo
08/25/2023

[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_SharingEnabled determina se o compartilhamento está habilitado nessa conexão.

Sintaxe

HRESULT get_SharingEnabled(
  [out] VARIANT_BOOL *pbEnabled
);

Parâmetros

[out] pbEnabled

Ponteiro para uma variável VARIANT_BOOL que, no retorno bem-sucedido, especifica se o compartilhamento é habilitado nessa conexão. Se o compartilhamento for habilitado, esse valor será TRUE. Caso contrário, será FALSE.

Valor retornado

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

Para determinar se o compartilhamento de conexão tem suporte no sistema operacional atualmente instalado, use INetSharingManager::get_SharingInstalled.

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

Requisitos


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