Método INetSharingManager::get_SharingInstalled (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_SharingInstalled relata se a versão atualmente instalada do Windows XP dá suporte ao compartilhamento de conexão.

Sintaxe

HRESULT get_SharingInstalled(
  [out] VARIANT_BOOL *pbInstalled
);

Parâmetros

[out] pbInstalled

Um ponteiro para um VARIANT_BOOL que especifica se a versão atualmente instalada do Windows XP dá suporte ao compartilhamento de conexão. Para obter mais informações, consulte Comentários.

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

Esse método define o parâmetro pbInstalled como TRUE quando chamado nas seguintes versões do Windows XP:

• Windows XP Home Edition
• Windows XP Professional
• Windows XP Embedded

Essa função define o parâmetro pbInstalled como FALSE quando chamado em outras versões do Windows XP.

Para determinar se o compartilhamento é habilitado para uma conexão específica, chame o método INetSharingConfiguration::get_SharingEnabled para essa conexão.

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

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