Interface INetwork (netlistmgr.h)

L’interface INetwork représente un réseau sur l’ordinateur local. Il peut également représenter une collection de connexions réseau avec une signature réseau similaire.

Héritage

L’interface INetwork hérite de l’interface IUnknown. INetwork a également les types de membres suivants :

Méthodes

L’interface INetwork possède ces méthodes.

INetwork ::get_IsConnected La propriété get_IsConnected spécifie si le réseau a une connectivité réseau.
INetwork ::get_IsConnectedToInternet La propriété get_IsConnectedToInternet spécifie si le réseau dispose d’une connectivité Internet.
INetwork ::GetCategory La méthode GetCategory retourne la catégorie d’un réseau.
INetwork ::GetConnectivity La méthode GetConnectivity retourne l’état de connectivité du réseau.
INetwork ::GetDescription La méthode GetDescription retourne une chaîne de description pour le réseau.
INetwork ::GetDomainType La méthode GetDomainType retourne le type de domaine d’un réseau.
INetwork ::GetName La méthode GetName retourne le nom d’un réseau.
INetwork ::GetNetworkConnections La méthode GetNetworkConnections retourne une énumération de toutes les connexions réseau pour un réseau. Un réseau peut avoir plusieurs connexions à partir d’interfaces différentes ou de liens différents à partir de la même interface.
INetwork ::GetNetworkId La méthode GetNetworkId retourne l’identificateur unique d’un réseau.
INetwork ::GetTimeCreatedAndConnected La méthode GetTimeCreatedAndConnected retourne la date et l’heure locales auxquelles le réseau a été créé et connecté.
INetwork ::SetCategory La méthode SetCategory définit la catégorie d’un réseau. Les modifications apportées prennent effet immédiatement. Les appelants de cette API doivent être membres du groupe Administrateurs.
INetwork ::SetDescription La méthode SetDescription définit ou remplace la description d’un réseau.
INetwork ::SetName La méthode SetName définit ou renomme un réseau.

Remarques

L’objet COM qui implémente INetwork implémente également un conteneur de propriétés pour des propriétés supplémentaires. Pour accéder à ce conteneur de propriétés, vous pouvez utiliser l’interface INetwork et QueryInterface pour IPropertyBag. Le conteneur de propriétés de cet objet COM contient les propriétés suivantes :

Paramètre	Type	Description
NA_DomainAuthenticationFailed	VT_BOOL	Spécifie qu’un réseau de domaine ne peut pas s’authentifier auprès du contrôleur de domaine.
NA_NetworkClass	NLM_NETWORK_CLASS valeur stockée en tant que VT_UINT	Spécifie la classe de réseau. Les valeurs possibles incluent : NLM_NETWORK_IDENTIFYING (0x01) Il s’agit du réseau spécial « Identification ». Aucune propriété de cette classe réseau ne peut être modifiée. NLM_NETWORK_IDENTIFIED (0x02) Il s’agit d’un réseau identifié. NLM_NETWORK_UNIDENTIFIED (0x03) Il s’agit du réseau spécial « Non identifié ». La catégorie de ce réseau peut être modifiée, mais elle ne persistera pas lorsque le réseau est déconnecté.
NA_InternetConnectivityV4 ou NA_InternetConnectivityV6	NLM_INTERNET_CONNECTIVITY valeur stockée en tant que VT_UINT	Fournit des détails sur la connectivité réseau IPv4 ou IPv6. Les valeurs possibles incluent : NLM_INTERNET_CONNECTIVITY_WEBHIJACK (0x1) Le réseau détecté est un point d’accès. Par exemple, lorsque vous êtes connecté à un réseau de café Wi-Fi point d’accès et que le trafic HTTP local est redirigé vers un portail captif, cet indicateur est défini. NLM_INTERNET_CONNECTIVITY_PROXIED (0x2) Le réseau détecté a une configuration de proxy. Par exemple, lorsque vous êtes connecté à un réseau d’entreprise à l’aide d’un proxy pour l’accès HTTP, cet indicateur est défini. NLM_INTERNET_CONNECTIVITY_CORPORATE (0x4) L’ordinateur a été configuré pour l’accès direct et l’accès est détecté au réseau de domaine d’entreprise pour lequel Direct Access a été configuré.
NA_NameSetByPolicy	VT_BOOL	Le nom du réseau a été défini par stratégie de groupe.
NA_IconSetByPolicy	VT_BOOL	L’icône du réseau a été définie par stratégie de groupe.
NA_DescriptionSetByPolicy	VT_BOOL	La description du réseau a été définie par stratégie de groupe.
NA_CategorySetByPolicy	VT_BOOL	La catégorie du réseau a été définie par stratégie de groupe.
NA_NameReadOnly	VT_BOOL	Le nom du réseau est en lecture seule.
NA_IconReadOnly	VT_BOOL	L’icône du réseau est en lecture seule.
NA_DescriptionReadOnly	VT_BOOL	La description du réseau est en lecture seule.
NA_CategoryReadOnly	VT_BOOL	La catégorie du réseau est en lecture seule.
NA_AllowMerge	VT_BOOL	Le réseau peut être fusionné avec un autre réseau.

 

L’interface IPropertyBag accepte LPCOLESTR dans le cadre des méthodes IPropertyBag ::Read et IPropertyBag ::Write. Pour des raisons pratiques, les valeurs de chaîne de ces propriétés sont définies dans netlistmgr.h en utilisant les mêmes noms.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	netlistmgr.h