Win32_NetworkConnection-Klasse

Artikel
06/12/2023

Die Win32_NetworkConnectionWMI-Klassestellt 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 befinden sich in alphabetischer Reihenfolge, nicht in MOF-Reihenfolge.

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;
};

Member

Die Win32_NetworkConnection-Klasse verfügt über folgende Membertypen:

Eigenschaften

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 von dem Benutzer oder der Gruppe verwaltet werden, in deren Namen die instance zurückgegeben wird. Auf FAT-Volumes wird stattdessen der wert FULL_ACCESS 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. Für ein Verzeichnis gewährt dieser Wert das Recht, eine Datei im Verzeichnis zu erstellen.

FILE_APPEND_DATA (Datei) 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 durchquert werden.

FILE_DELETE_CHILD (Verzeichnis) (64)

Gewährt das Recht, ein Verzeichnis und alle darin enthaltenen Dateien (die 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.

READ_CONTROL (131072)

Gewährt Lesezugriff auf die Sicherheitsbeschreibung und den Sicherheitsbesitzer.

WRITE_DAC (262144)

Gewährt Schreibzugriff auf die diskretionäre Zugriffssteuerungsliste (DACL).

WRITE_OWNER (524288)

Weist den Schreibbesitzer zu.

SYNCHRONISIEREN (1048576)

Synchronisiert den Zugriff und ermöglicht einem Prozess, auf den Eintritt eines Objekts in den signalierten Zustand zu warten.

Caption

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen (64), DisplayName ("Caption")

Eine kurze Textbeschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Comment

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32API| Windows-Netzwerkstrukturen| NETRESOURCE|lpComment")

Kommentar des Netzwerkanbieters.

ConnectionState

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen (20), MappingStrings ("Win32API| Netzwerkverwaltungsstrukturen| | USE_INFO_1 ui1_status")

Aktueller Zustand der Netzwerkverbindung.

Verbunden ("Verbunden")

Fehler ("Fehler")

Angehalten ("Angehalten")

Getrennt ("Getrennt")

Herstellen einer Verbindung ("Verbinden")

Erneute Verbindung ("Erneute Verbindung")

ConnectionType

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32API| Windows-Netzwerkstrukturen| NETRESOURCE|dwScope")

Persistenztyp der Verbindung, die für die Verbindung mit dem Netzwerk verwendet wird.

Aktuelle Verbindung ("Aktuelle Verbindung")

Persistente Verbindung ("Persistente Verbindung")

Beschreibung

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: DisplayName ("Description")

Eine Textbeschreibung des -Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

DisplayType

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32API| Windows-Netzwerkstrukturen| NETRESOURCE|dwDisplayType")

Das Netzwerkobjekt sollte in einer Benutzeroberfläche für das Surfen im Netzwerk angezeigt werden.

Domäne ("Domäne")

Generic ("Generic")

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 bedeutet nicht, dass das Objekt nicht installiert ist.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Localname

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32API| Windows-Netzwerkstrukturen| NETRESOURCE|lpLocalName")

Lokaler Name des verbundenen Netzwerkgeräts.

Beispiel: "c:\public"

Name

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: schlüssel, überschreiben ("Name"), MappingStrings ("Win32API| Windows-Netzwerkstrukturen| NETRESOURCE")

Name der aktuellen Netzwerkverbindung. Dies ist die Kombination der Werte in RemoteName und LocalName.

Beispiel: "\\NTRELEASE (c:\public)"

Persistent

Datentyp: Boolesch
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32API| Windows-Netzwerkfunktionen| WNetEnumResource")

Die Verbindung wird bei der nächsten Anmeldung automatisch vom Betriebssystem wiederhergestellt.

ProviderName

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32API| Windows-Netzwerkstrukturen| 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-Netzwerkstrukturen| NETRESOURCE|lpRemoteName")

Remotenetzwerkressourcenname für eine Netzwerkressource. Bei einer aktuellen oder dauerhaften Verbindung enthält RemoteName den Netzwerknamen, der dem Namen des Werts in der LocalName-Eigenschaft zugeordnet ist. Der Name in RemoteName muss den Benennungskonventionen des Netzwerkanbieters entsprechen.

Beispiel: "\\NTRELEASE"

RemotePath

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32API| Windows-Netzwerkstrukturen| NETRESOURCE|lpRemoteName")

Vollständiger Pfad zur Netzwerkressource.

Beispiel: "\\infosrv1\public"

ResourceType

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32API| Windows-Netzwerkstrukturen| NETRESOURCE|dwType")

Art der Ressource, mit der eine Aufzählung oder Verbindung hergestellt werden soll.

Datenträger ("Datenträger")

Drucken ("Print")

Any ("Any")

Status

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen (10), DisplayName ("Status")

Zeichenfolge, die den aktuellen status des Objekts angibt. Es können operative und nicht operative status definiert werden. Operative status können "OK", "Degraded" und "Pred Fail" enthalten. "Pred Fail" gibt an, dass ein Element ordnungsgemäß funktioniert, aber einen Fehler vorhersagt (z. B. ein SMART-fähiges Festplattenlaufwerk).

Nicht betriebsbereite status können "Error", "Starting", "Stop" und "Service" enthalten. "Dienst" kann beim Spiegel des Datenträgers, beim erneuten Laden einer Benutzerberechtigungsliste oder bei anderen Administrativen Arbeiten angewendet werden. Nicht alle derartigen 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")

Degraded ("Degraded")

Unbekannt ("Unbekannt")

Pred Fail ("Pred Fail")

Starten ("Start")

Beenden ("Beenden")

Dienst ("Dienst")

Gestresst ("Gestresst")

NonRecover ("NonRecover")

Kein Kontakt ("Kein Kontakt")

Lost Comm ("Lost Comm")

UserName

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32API| Windows-Netzwerkfunktionen| 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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	WindowsServer 2008
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Siehe auch

CIM_LogicalElement
Betriebssystemklassen

Freigeben über

Win32_NetworkConnection-Klasse

Syntax

Member

Eigenschaften

Bemerkungen

Beispiele

Anforderungen

Siehe auch

Feedback

Zusätzliche Ressourcen