Partager via


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