Interfaz INetwork (netlistmgr.h)

La interfaz INetwork representa una red en el equipo local. También puede representar una colección de conexiones de red con una firma de red similar.

Herencia

La interfaz INetwork hereda de la interfaz IUnknown . INetwork también tiene estos tipos de miembros:

Métodos

La interfaz INetwork tiene estos métodos.

INetwork::get_IsConnected La propiedad get_IsConnected especifica si la red tiene conectividad de red.
INetwork::get_IsConnectedToInternet La propiedad get_IsConnectedToInternet especifica si la red tiene conectividad a Internet.
INetwork::GetCategory El método GetCategory devuelve la categoría de una red.
INetwork::GetConnectivity El método GetConnectivity devuelve el estado de conectividad de la red.
INetwork::GetDescription El método GetDescription devuelve una cadena de descripción para la red.
INetwork::GetDomainType El método GetDomainType devuelve el tipo de dominio de una red.
INetwork::GetName El método GetName devuelve el nombre de una red.
INetwork::GetNetworkConnections El método GetNetworkConnections devuelve una enumeración de todas las conexiones de red para una red. Una red puede tener varias conexiones a ella desde interfaces diferentes o vínculos diferentes de la misma interfaz.
INetwork::GetNetworkId El método GetNetworkId devuelve el identificador único de una red.
INetwork::GetTimeCreatedAndConnected El método GetTimeCreatedAndConnected devuelve la fecha y hora locales en que se creó y conectó la red.
INetwork::SetCategory El método SetCategory establece la categoría de una red. Los cambios realizados surten efecto inmediatamente. Los autores de llamadas de esta API deben ser miembros del grupo Administradores.
INetwork::SetDescription El método SetDescription establece o reemplaza la descripción de una red.
INetwork::SetName El método SetName establece o cambia el nombre de una red.

Comentarios

El objeto COM que implementa INetwork también implementa un contenedor de propiedades para propiedades adicionales. Para obtener acceso a este contenedor de propiedades, puede usar la interfaz INetwork y QueryInterface para IPropertyBag. El contenedor de propiedades de este objeto COM contiene las siguientes propiedades:

Parámetro	Tipo	Descripción
NA_DomainAuthenticationFailed	VT_BOOL	Especifica que una red de dominio no puede autenticarse en el controlador de dominio.
NA_NetworkClass	NLM_NETWORK_CLASS valor almacenado como VT_UINT	Especifica la clase de red. Los valores posibles son: NLM_NETWORK_IDENTIFYING (0x01) Esta es la red especial "Identificación". No se puede cambiar ninguna propiedad de esta clase de red. NLM_NETWORK_IDENTIFIED (0x02) Se trata de una red identificada. NLM_NETWORK_UNIDENTIFIED (0x03) Esta es la red especial "No identificada". Se puede cambiar la categoría de esta red, pero no se conservará cuando se desconecte la red.
NA_InternetConnectivityV4 o NA_InternetConnectivityV6	NLM_INTERNET_CONNECTIVITY valor almacenado como VT_UINT	Proporciona detalles sobre la conectividad de red IPv4 o IPv6. Los valores posibles son: NLM_INTERNET_CONNECTIVITY_WEBHIJACK (0x1) La red detectada es un punto de acceso. Por ejemplo, cuando se conecta a una red de zona activa de café Wi-Fi y el tráfico HTTP local se redirige a un portal cautivo, se establecerá esta marca. NLM_INTERNET_CONNECTIVITY_PROXIED (0x2) La red detectada tiene una configuración de proxy. Por ejemplo, cuando se conecta a una red corporativa mediante un proxy para el acceso HTTP, se establecerá esta marca. NLM_INTERNET_CONNECTIVITY_CORPORATE (0x4) La máquina se ha configurado para Direct Access y el acceso se detecta en la red de dominio corporativo Direct Access para la que se ha configurado.
NA_NameSetByPolicy	VT_BOOL	La directiva de grupo ha establecido el nombre de la red.
NA_IconSetByPolicy	VT_BOOL	La directiva de grupo ha establecido el icono de la red.
NA_DescriptionSetByPolicy	VT_BOOL	La descripción de la red se ha establecido mediante la directiva de grupo.
NA_CategorySetByPolicy	VT_BOOL	La categoría de la red se ha establecido mediante la directiva de grupo.
NA_NameReadOnly	VT_BOOL	El nombre de la red es de solo lectura.
NA_IconReadOnly	VT_BOOL	El icono de la red es de solo lectura.
NA_DescriptionReadOnly	VT_BOOL	La descripción de la red es de solo lectura.
NA_CategoryReadOnly	VT_BOOL	La categoría de la red es de solo lectura.
NA_AllowMerge	VT_BOOL	La red se puede combinar con otra red.

 

La interfaz IPropertyBag acepta LPCOLESTR como parte de los métodos IPropertyBag::Read e IPropertyBag::Write . Por comodidad, los valores de cadena de estas propiedades se definen dentro de netlistmgr.h con los mismos nombres.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	netlistmgr.h