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
CIMWin32.mof
DLL
CIMWin32.dll

Weitere Informationen

CIM _ LogicalElement

Betriebssystemklassen