classe Win32_NetworkConnection

La classe WMIWin32_NetworkConnection représente une connexion réseau active dans un environnement Windows.

La syntaxe suivante est simplifiée par rapport au code MOF (Managed Object Format) et inclut toutes les propriétés héritées. Les propriétés et les méthodes sont dans l’ordre alphabétique, et non dans l’ordre MOF.

Syntaxe

[Dynamic, Provider("CIMWin32"), UUID("{8502C4CD-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_NetworkConnection : CIM_LogicalElement
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Status;
  uint32   AccessMask;
  string   Comment;
  string   ConnectionState;
  string   ConnectionType;
  string   DisplayType;
  string   LocalName;
  string   Name;
  boolean  Persistent;
  string   ProviderName;
  string   RemoteName;
  string   RemotePath;
  string   ResourceType;
  string   UserName;
};

Membres

La classe Win32_NetworkConnection a les types de membres suivants :

Propriétés

La classe Win32_NetworkConnection possède ces propriétés.

AccessMask

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : Schéma (« Win32 »)

Liste des droits d’accès au fichier ou répertoire donné détenu par l’utilisateur ou le groupe au nom duquel le instance est retourné. Sur les volumes FAT, la valeur FULL_ACCESS est retournée à la place, indiquant qu’aucune sécurité n’a été définie sur l’objet.

FILE_READ_DATA (fichier) ou FILE_LIST_DIRECTORY (répertoire) (1)

Accorde le droit de lire les données du fichier. Pour un répertoire, cette valeur accorde le droit de répertorier le contenu du répertoire.

FILE_WRITE_DATA (fichier) ou FILE_ADD_FILE (répertoire) (2)

Accorde le droit d’écrire des données dans le fichier. Pour un répertoire, cette valeur accorde le droit de créer un fichier dans le répertoire.

FILE_APPEND_DATA (fichier) ou FILE_ADD_SUBDIRECTORY (4)

Accorde le droit d’ajouter des données au fichier. Pour un répertoire, cette valeur accorde le droit de créer un sous-répertoire.

FILE_READ_EA (8)

Accorde le droit de lire les attributs étendus.

FILE_WRITE_EA (16)

Accorde le droit d’écrire des attributs étendus.

FILE_EXECUTE (fichier) ou FILE_TRAVERSE (répertoire) (32)

Accorde le droit d’exécuter un fichier. Pour un répertoire, le répertoire peut être parcouru.

FILE_DELETE_CHILD (répertoire) (64)

Accorde le droit de supprimer un répertoire et tous les fichiers qu’il contient (ses enfants), même si les fichiers sont en lecture seule.

FILE_READ_ATTRIBUTES (128)

Accorde le droit de lire les attributs de fichier.

FILE_WRITE_ATTRIBUTES (256)

Accorde le droit de modifier les attributs de fichier.

DELETE (65536)

Octroie l’accès à la suppression.

READ_CONTROL (131072)

Octroie l’accès en lecture au descripteur de sécurité et au propriétaire.

WRITE_DAC (262144)

Octroie l’accès en écriture à la liste de contrôle d’accès discrétionnaire (DACL).

WRITE_OWNER (524288)

Affecte le propriétaire d’écriture.

SYNCHRONIZE (1048576)

Synchronise l’accès et permet à un processus d’attendre qu’un objet entre dans l’état signalé.

Caption

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (64), DisplayName (« Caption »)

Brève description textuelle de l’objet.

Cette propriété est héritée de CIM_ManagedSystemElement.

Commentaire

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Structures de mise en réseau Windows | NETRESOURCE|lpComment « )

Commentaire fourni par le fournisseur réseau.

ConnectionState

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (20), MappingStrings (« Win32API| Structures de gestion réseau | | USE_INFO_1 ui1_status »)

État actuel de la connexion réseau.

Connecté (« Connecté »)

Erreur (« Erreur »)

Suspendu (« Suspendu »)

Déconnecté (« Déconnecté »)

Connexion (« Connexion »)

Reconnexion (« Reconnexion »)

ConnectionType

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Structures de mise en réseau Windows | NETRESOURCE|dwScope »)

Type de persistance de la connexion utilisée pour la connexion au réseau.

Connexion actuelle (« Connexion actuelle »)

Connexion permanente (« Connexion permanente »)

Description

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Description »)

Description textuelle de l’objet.

Cette propriété est héritée de CIM_ManagedSystemElement.

DisplayType

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Structures de mise en réseau Windows | NETRESOURCE|dwDisplayType »)

L’objet réseau doit être affiché dans une interface utilisateur de navigation réseau.

Domaine (« Domaine »)

Générique (« Générique »)

Serveur (« Serveur »)

Partager (« Partager »)

InstallDate

Type de données : datetime

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« MIF. DMTF| ComponentID|001.5 »), DisplayName (« Date d’installation »)

Indique quand l’objet a été installé. L’absence d’une valeur n’indique pas que l’objet n’est pas installé.

Cette propriété est héritée de CIM_ManagedSystemElement.

Localname

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Structures de mise en réseau Windows | NETRESOURCE|lpLocalName »)

Nom local du périphérique réseau connecté.

Exemple : « c:\public »

Nom

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : key, Override (« Name »), MappingStrings (« Win32API| Structures de mise en réseau Windows | NETRESOURCE »)

Nom de la connexion réseau actuelle. Il s’agit de la combinaison des valeurs dans RemoteName et LocalName.

Exemple : « \\NTRELEASE (c:\public) »

Persistent

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Fonctions de mise en réseau Windows | WNetEnumResource »)

La connexion sera automatiquement reconnectée par le système d’exploitation lors de la prochaine ouverture de session.

ProviderName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Structures de mise en réseau Windows | NETRESOURCE|lpProvider »)

Nom du fournisseur propriétaire de la ressource. Cette propriété peut être NULL si le nom du fournisseur est inconnu.

RemoteName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Structures de mise en réseau Windows | NETRESOURCE|lpRemoteName »)

Nom de ressource réseau distante pour une ressource réseau. Pour une connexion actuelle ou persistante, RemoteName contient le nom réseau associé au nom de la valeur dans la propriété LocalName . Le nom dans RemoteName doit suivre les conventions d’affectation de noms du fournisseur de réseau.

Exemple : « \\NTRELEASE »

RemovePath

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Structures de mise en réseau Windows | NETRESOURCE|lpRemoteName »)

Chemin d’accès complet à la ressource réseau.

Exemple : « \\infosrv1\public »

ResourceType

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Structures de mise en réseau Windows | NETRESOURCE|dwType »)

Type de ressource à énumérer ou à laquelle se connecter.

Disque (« Disque »)

Imprimer (« Imprimer »)

N’importe quel (« Tout »)

État

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (10), DisplayName (« Status »)

Chaîne qui indique la status actuelle de l’objet. Les status opérationnelles et non opérationnelles peuvent être définies. Les status opérationnelles peuvent inclure « OK », « Détérioré » et « Échec anticipé ». « Échec anticipé » indique qu’un élément fonctionne correctement, mais qu’il prédit une défaillance (par exemple, un lecteur de disque dur compatible SMART).

Les status non opérationnelles peuvent inclure « Erreur », « Démarrage », « Arrêt » et « Service ». Le « service » peut s’appliquer pendant la miroir disque, le rechargement d’une liste d’autorisations utilisateur ou d’autres tâches administratives. Tous ces travaux ne sont pas en ligne, mais l’élément managé n’est ni « OK » ni dans l’un des autres états.

Cette propriété est héritée de CIM_ManagedSystemElement.

Les valeurs sont notamment les suivantes :

OK (« OK »)

Erreur (« Erreur »)

Détérioré (« Détérioré »)

Inconnu (« Inconnu »)

Échec de la préversion (« Échec prédé »)

Démarrage (« Démarrage »)

Arrêt (« Arrêt »)

Service (« Service »)

Stressé (« Stressé »)

NonRecover (« NonRecover »)

Aucun contact (« Aucun contact »)

Lost Comm (« Lost Comm »)

UserName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Fonctions de mise en réseau Windows | WNetGetUser »)

Nom d’utilisateur ou nom d’utilisateur par défaut utilisé pour établir une connexion réseau.

Exemple : « SYSTEM »

Notes

La classe Win32_NetworkConnection est dérivée de CIM_LogicalElement.

Exemples

L’exemple de code VBScript suivant récupère des informations sur la connexion au réseau local.

On Error Resume Next
strComputer = "."
Set objWMIService = GetObject("winmgmts:\\" & strComputer & "\Root\CIMv2")
Set colItems = objWMIService.ExecQuery("Select * from Win32_NetworkConnection",,48)
For Each objItem in colItems
    Wscript.Echo "AccessMask: " & objItem.AccessMask
    Wscript.Echo "Caption: " & objItem.Caption
    Wscript.Echo "Comment: " & objItem.Comment
    Wscript.Echo "ConnectionState: " & objItem.ConnectionState
    Wscript.Echo "ConnectionType: " & objItem.ConnectionType
    Wscript.Echo "Description: " & objItem.Description
    Wscript.Echo "DisplayType: " & objItem.DisplayType
    Wscript.Echo "InstallDate: " & objItem.InstallDate
    Wscript.Echo "LocalName: " & objItem.LocalName
    Wscript.Echo "Name: " & objItem.Name
    Wscript.Echo "Persistent: " & objItem.Persistent
    Wscript.Echo "ProviderName: " & objItem.ProviderName
    Wscript.Echo "RemoteName: " & objItem.RemoteName
    Wscript.Echo "RemotePath: " & objItem.RemotePath
    Wscript.Echo "ResourceType: " & objItem.ResourceType
    Wscript.Echo "Status: " & objItem.Status
    Wscript.Echo "UserName: " & objItem.UserName
Next

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows Vista
Serveur minimal pris en charge
Windows Server 2008
Espace de noms
Racine\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Voir aussi

CIM_LogicalElement

Classes du système d’exploitation