Interface INetwork (netlistmgr.h)

A interface INetwork representa uma rede no computador local. Ele também pode representar uma coleção de conexões de rede com uma assinatura de rede semelhante.

Herança

A interface INetwork herda da interface IUnknown . A INetwork também tem esses tipos de membros:

Métodos

A interface INetwork tem esses métodos.

INetwork::get_IsConnected A propriedade get_IsConnected especifica se a rede tem conectividade de rede.
INetwork::get_IsConnectedToInternet A propriedade get_IsConnectedToInternet especifica se a rede tem conectividade com a Internet.
INetwork::GetCategory O método GetCategory retorna a categoria de uma rede.
INetwork::GetConnectivity O método GetConnectivity retorna o estado de conectividade da rede.
INetwork::GetDescription O método GetDescription retorna uma cadeia de caracteres de descrição para a rede.
INetwork::GetDomainType O método GetDomainType retorna o tipo de domínio de uma rede.
INetwork::GetName O método GetName retorna o nome de uma rede.
INetwork::GetNetworkConnections O método GetNetworkConnections retorna uma enumeração de todas as conexões de rede para uma rede. Uma rede pode ter várias conexões com ela de diferentes interfaces ou links diferentes da mesma interface.
INetwork::GetNetworkId O método GetNetworkId retorna o identificador exclusivo de uma rede.
INetwork::GetTimeCreatedAndConnected O método GetTimeCreatedAndConnected retorna a data e a hora locais em que a rede foi criada e conectada.
INetwork::SetCategory O método SetCategory define a categoria de uma rede. As alterações feitas entrarão em vigor imediatamente. Os chamadores dessa API devem ser membros do grupo Administradores.
INetwork::SetDescription O método SetDescription define ou substitui a descrição de uma rede.
INetwork::SetName O método SetName define ou renomeia uma rede.

Comentários

O Objeto COM que implementa iNetwork também implementa um recipiente de propriedades para propriedades adicionais. Para obter acesso a esse recipiente de propriedades, você pode usar a interface INetwork e QueryInterface para IPropertyBag. O recipiente de propriedades neste objeto COM contém as seguintes propriedades:

Parâmetro	Tipo	Descrição
NA_DomainAuthenticationFailed	VT_BOOL	Especifica que uma rede de domínio não é capaz de se autenticar no controlador de domínio.
NA_NetworkClass	NLM_NETWORK_CLASS valor armazenado como VT_UINT	Especifica a classe de rede. Os valores possíveis incluem: NLM_NETWORK_IDENTIFYING (0x01) Essa é a rede especial de "Identificação". Nenhuma propriedade nessa classe de rede pode ser alterada. NLM_NETWORK_IDENTIFIED (0x02) Essa é uma rede identificada. NLM_NETWORK_UNIDENTIFIED (0x03) Esta é a rede especial "Não identificada". A categoria dessa rede pode ser alterada, mas não persistirá quando a rede for desconectada.
NA_InternetConnectivityV4 ou NA_InternetConnectivityV6	NLM_INTERNET_CONNECTIVITY valor armazenado como VT_UINT	Fornece detalhes sobre a conectividade de rede IPv4 ou IPv6. Os valores possíveis incluem: NLM_INTERNET_CONNECTIVITY_WEBHIJACK (0x1) A rede detectada é um ponto de acesso. Por exemplo, quando conectado a um café Wi-Fi rede de hotspots e o tráfego HTTP local está sendo redirecionado para um portal cativo, esse sinalizador será definido. NLM_INTERNET_CONNECTIVITY_PROXIED (0x2) A rede detectada tem uma configuração de proxy. Por exemplo, quando conectado a uma rede corporativa usando um proxy para acesso HTTP, esse sinalizador será definido. NLM_INTERNET_CONNECTIVITY_CORPORATE (0x4) O computador foi configurado para Acesso Direto e o acesso é detectado para a rede de domínio corporativo para a qual o Acesso Direto foi configurado.
NA_NameSetByPolicy	VT_BOOL	O nome da rede foi definido pela política de grupo.
NA_IconSetByPolicy	VT_BOOL	O ícone da rede foi definido pela política de grupo.
NA_DescriptionSetByPolicy	VT_BOOL	A descrição da rede foi definida pela política de grupo.
NA_CategorySetByPolicy	VT_BOOL	A categoria da rede foi definida pela política de grupo.
NA_NameReadOnly	VT_BOOL	O nome da rede é somente leitura.
NA_IconReadOnly	VT_BOOL	O ícone da rede é somente leitura.
NA_DescriptionReadOnly	VT_BOOL	A descrição da rede é somente leitura.
NA_CategoryReadOnly	VT_BOOL	A categoria da rede é somente leitura.
NA_AllowMerge	VT_BOOL	A rede pode ser mesclada com outra rede.

 

A interface IPropertyBag aceita LPCOLESTR como parte dos métodos IPropertyBag::Read e IPropertyBag::Write . Para sua conveniência, os valores de cadeia de caracteres para essas propriedades são definidos dentro de netlistmgr.h usando os mesmos nomes.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	netlistmgr.h