Win32 _ NetworkConnection-Klasse
Die WMI-Klasse Win32 _ NetworkConnection stellt eine aktive Netzwerkverbindung in einer Windows-basierten Umgebung dar.
Die folgende Syntax wurde aus MOF-Code (Managed Object Format, verwaltetes Objektformat) vereinfacht und enthält alle geerbten Eigenschaften. Eigenschaften und Methoden werden in alphabetischer Reihenfolge und nicht in MOF-Reihenfolge sortiert.
Syntax
[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;
};
Members
Die Win32 _ NetworkConnection-Klasse verfügt über folgende Typen von Membern:
Eigenschaften
Die Win32 _ NetworkConnection-Klasse verfügt über diese Eigenschaften.
-
Accessmask
-
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schema ("Win32")
Liste der Zugriffsrechte für die angegebene Datei oder das Angegebene Verzeichnis, die bzw. das der Benutzer oder die Gruppe in dessen Auftrag die Instanz zurückgegeben wird. Auf FAT-Volumes wird stattdessen der FULL _ ACCESS-Wert zurückgegeben, der angibt, dass keine Sicherheit für das Objekt festgelegt wurde.
-
-
FILE _ READ _ DATA (Datei) oder FILE _ LIST DIRECTORY _ (Verzeichnis) (1)
-
Gewährt das Recht, Daten aus der Datei zu lesen. Für ein Verzeichnis gewährt dieser Wert das Recht, den Inhalt des Verzeichnisses aufzulisten.
-
FILE _ WRITE _ DATA (Datei) oder FILE _ ADD FILE _ (Verzeichnis) (2)
-
Gewährt das Recht, Daten in die Datei zu schreiben. Bei einem Verzeichnis gewährt dieser Wert das Recht, eine Datei im Verzeichnis zu erstellen.
-
FILE _ APPEND _ DATA (File) oder FILE _ ADD _ SUBDIRECTORY (4)
-
Gewährt das Recht, Daten an die Datei anzufügen. Für ein Verzeichnis gewährt dieser Wert das Recht, ein Unterverzeichnis zu erstellen.
-
FILE _ READ _ EA (8)
-
Gewährt das Recht, erweiterte Attribute zu lesen.
-
FILE _ _WRITE EA (16)
-
Gewährt das Recht, erweiterte Attribute zu schreiben.
-
FILE _ EXECUTE (Datei) oder FILE _ TRAVERSE (Verzeichnis) (32)
-
Gewährt das Recht zum Ausführen einer Datei. Für ein Verzeichnis kann das Verzeichnis durchlaufen werden.
-
FILE _ DELETE _ CHILD (Verzeichnis) (64)
-
Gewährt das Recht, ein Verzeichnis und alle darin enthaltenen Dateien (seine untergeordneten Dateien) zu löschen, auch wenn die Dateien schreibgeschützt sind.
-
FILE _ READ _ ATTRIBUTES (128)
-
Gewährt das Recht zum Lesen von Dateiattributen.
-
FILE _ WRITE _ ATTRIBUTES (256)
-
Gewährt das Recht, Dateiattribute zu ändern.
-
DELETE (65536)
-
Gewährt Löschzugriff.
-
LESEN _ CONTROL (131072)
-
Gewährt Lesezugriff auf den Sicherheitsdeskriptor und den Besitzer.
-
WRITE _ DAC (262144)
-
Gewährt Schreibzugriff auf die DACL (Discretionary Access Control List).
-
WRITE _ OWNER (524288)
-
Weist den Schreibbesitzer zu.
-
SYNCHRONIZE (1048576)
-
Synchronisiert den Zugriff und ermöglicht einem Prozess, auf den Eintritt eines Objekts in den signalisierten Zustand zu warten.
Caption
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen (64), DisplayName ("Caption")
Eine kurze Textbeschreibung des Objekts.
Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.
Comment
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("Win32API | Windows Netzwerkstrukturen | NETRESOURCE | lpComment")
Vom Netzwerkanbieter bereitgestellter Kommentar.
ConnectionState
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen (20), MappingStrings ("Win32API-Netzwerkverwaltungsstrukturen | | USE INFO _ _ 1 | ui1 _ status")
Aktueller Status der Netzwerkverbindung.
Verbunden ("Verbunden")
Fehler ("Fehler")
Angehalten ("Angehalten")
Getrennt ("Getrennt")
Herstellen einer Verbindung ("Verbinden")
Wiederherstellen der Verbindung ("Erneutes Herstellen einer Verbindung")
ConnectionType
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("Win32API | Windows Netzwerkstrukturen | NETRESOURCE | dwScope")
Persistenztyp der Verbindung, die zum Herstellen einer Verbindung mit dem Netzwerk verwendet wird.
Aktuelle Verbindung ("Aktuelle Verbindung")
Persistente Verbindung ("Persistente Verbindung")
Beschreibung
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: DisplayName ("Beschreibung")
Eine Textbeschreibung des Objekts.
Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.
DisplayType
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("Win32API | Windows Netzwerkstrukturen | NETRESOURCE | dwDisplayType")
Das Netzwerkobjekt sollte auf einer Benutzeroberfläche für die Netzwerksuche angezeigt werden.
Domäne ("Domäne")
Generisch ("Generisch")
Server ("Server")
Freigeben ("Freigeben")
InstallDate
-
Datentyp: datetime
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("MIF. DMTF | ComponentID | 001.5"), DisplayName ("Installationsdatum")
Gibt an, wann das Objekt installiert wurde. Das Fehlen eines Werts gibt nicht an, dass das Objekt nicht installiert ist.
Diese Eigenschaft wird von CIM _ ManagedSystemElement geerbt.
Localname
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("Win32API | Windows Networking Structures | NETRESOURCE | lpLocalName")
Lokaler Name des verbundenen Netzwerkgeräts.
Beispiel: "c: \ public"
Name
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: schlüssel, Override ("Name"), MappingStrings ("Win32API | Windows Networking Structures | NETRESOURCE")
Name der aktuellen Netzwerkverbindung. Dies ist die Kombination der Werte in RemoteName und LocalName.
Beispiel: " \ \ NTRELEASE (c: \ public)"
Persistent
-
Datentyp: boolescher Wert
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("Win32API | Windows Networking Functions | WNetEnumResource")
Die Verbindung wird bei der nächsten Anmeldung automatisch vom Betriebssystem wiederhergestellt.
ProviderName
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("Win32API | Windows Networking Structures | NETRESOURCE | lpProvider")
Name des Anbieters, der die Ressource besitzt. Diese Eigenschaft kann NULL sein, wenn der Anbietername unbekannt ist.
RemoteName
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("Win32API | Windows Networking Structures | NETRESOURCE | lpRemoteName")
Name der Remotenetzwerkressource für eine Netzwerkressource. Für eine aktuelle oder persistente Verbindung enthält RemoteName den Netzwerknamen, der dem Namen des Werts in der LocalName-Eigenschaft zugeordnet ist. Der Name in RemoteName muss den Namenskonventionen des Netzwerkanbieters entsprechen.
Beispiel: \ \ "NTRELEASE"
RemotePath
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("Win32API | Windows Networking Structures | NETRESOURCE | lpRemoteName")
Vollständiger Pfad zur Netzwerkressource.
Beispiel: \ \ "infosrv1 \ public"
ResourceType
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("Win32API | Windows Networking Structures | NETRESOURCE | dwType")
Typ der Ressource, mit der enumeriert oder eine Verbindung hergestellt werden soll.
Datenträger ("Datenträger")
Drucken ("Drucken")
Any ("Any")
Status
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen (10), DisplayName ("Status")
Eine Zeichenfolge, die den aktuellen Status des Objekts angibt. Betriebsstatus und nicht betriebsbereiter Status können definiert werden. Der Betriebsstatus kann "OK", "Heruntergestuft" und "Fehler vor dem Ausfall" enthalten. "Pred Fail" gibt an, dass ein Element ordnungsgemäß funktioniert, aber einen Fehler vorhersagt (z. B. eine SMART-fähige Festplatte).
Nicht betriebsbereite Status können "Error", "Starting", "Stopping" und "Service" sein. "Dienst" kann während der Spiegelung des Datenträgers, beim erneuten Laden einer Benutzerberechtigungsliste oder bei anderen administrativen Aufgaben angewendet werden. Nicht alle diese Arbeiten sind online, aber das verwaltete Element ist weder "OK" noch in einem der anderen Zustände.
Diese Eigenschaft wird von CIM _ ManagedSystemElement geerbt.
Folgende Werte sind gültig:
OK ("OK")
Fehler ("Fehler")
Heruntergestuft ("Heruntergestuft")
Unbekannt ("Unbekannt")
Pred Fail ("Pred Fail")
Wird gestartet ("Wird gestartet")
Wird beendet ("Wird beendet")
Dienst ("Dienst")
Striche ("Strich")
NonRecover ("NonRecover")
Kein Kontakt ("Kein Kontakt")
Lost Comm ("Lost Comm")
UserName
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("Win32API | Windows Networking Functions | WNetGetUser")
Benutzername oder Der Standardbenutzername, der zum Herstellen einer Netzwerkverbindung verwendet wird.
Beispiel: "SYSTEM"
Bemerkungen
Die Win32 _ NetworkConnection-Klasse wird von CIM _ LogicalElement abgeleitet.
Beispiele
Im folgenden VBScript-Codebeispiel werden Informationen zur lokalen Netzwerkverbindung abgerufen.
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
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Namespace |
\Stamm-CIMV2 |
| MOF |
|
| DLL |
|