Win32_NetworkProtocol-Klasse

  • Artikel

Die Win32_NetworkProtocolWMI-Klasse stellt ein Protokoll und seine Netzwerkeigenschaften auf einem Win32-Computersystem 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("{8502C4D8-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_NetworkProtocol : CIM_LogicalElement
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Status;
  boolean  ConnectionlessService;
  boolean  GuaranteesDelivery;
  boolean  GuaranteesSequencing;
  uint32   MaximumAddressSize;
  uint32   MaximumMessageSize;
  boolean  MessageOriented;
  uint32   MinimumAddressSize;
  string   Name;
  boolean  PseudoStreamOriented;
  boolean  SupportsBroadcasting;
  boolean  SupportsConnectData;
  boolean  SupportsDisconnectData;
  boolean  SupportsEncryption;
  boolean  SupportsExpeditedData;
  boolean  SupportsFragmentation;
  boolean  SupportsGracefulClosing;
  boolean  SupportsGuaranteedBandwidth;
  boolean  SupportsMulticasting;
  boolean  SupportsQualityofService;
};

Member

Die Win32_NetworkProtocol-Klasse verfügt über die folgenden Membertypen:

Eigenschaften

Die Win32_NetworkProtocol-Klasse verfügt über diese Eigenschaften.

Caption

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (64), DisplayName ("Caption")

Eine kurze Textbeschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

ConnectionlessService

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32_API| Windows Sockets-Strukturen| PROTOCOL_INFO|dwServiceFlags| XP1_CONNECTIONLESS")

Das Protokoll unterstützt den verbindungslosen Dienst. Ein verbindungsloser Dienst (Datagramm) beschreibt ein Kommunikationsprotokoll oder einen Transport, bei dem Datenpakete unabhängig voneinander weitergeleitet werden und möglicherweise unterschiedliche Routen verfolgen und in einer anderen Reihenfolge als in der gesendeten Reihenfolge ankommen. Umgekehrt stellt ein verbindungsorientierter Dienst eine virtuelle Verbindung bereit, über die Datenpakete in der gleichen Reihenfolge empfangen werden, in der sie übertragen wurden. Wenn die Verbindung zwischen Computern fehlschlägt, wird die Anwendung benachrichtigt.

Beschreibung

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Description")

Eine Textbeschreibung des -Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

GarantienDelivery

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32_API| Windows Sockets-Strukturen| PROTOCOL_INFO|dwServiceFlags| XP_GUARANTEED_DELIVERY")

Das Protokoll unterstützt die Übermittlung von Datenpaketen. Wenn dieses Flag FALSE ist, ist es unsicher, dass alle gesendeten Daten das gewünschte Ziel erreichen.

GarantienSequencing

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32_API| Windows Sockets-Strukturen| PROTOCOL_INFO|dwServiceFlags| XP_GUARANTEED_ORDER")

Das Protokoll stellt sicher, dass die Daten in der Reihenfolge eintreffen, in der sie gesendet wurden. Beachten Sie, dass diese Eigenschaft nicht die Übermittlung der Daten gewährleistet, nur die Reihenfolge.

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.

MaximumAddressSize

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32_API| Windows Sockets-Strukturen| PROTOCOL_INFO|iMaxSockAddr"), Einheiten ("Zeichen")

Maximale Länge einer Socketadresse, die vom Protokoll unterstützt wird. Socketadressen können Elemente wie eine URL (www.microsoft.com) oder eine IP-Adresse (130.215.24.1) sein.

MaximumMessageSize

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32_API| Windows Sockets-Strukturen| PROTOCOL_INFO|dwMessageSize"), Einheiten ("Zeichen")

Die vom Protokoll unterstützte maximale Nachrichtengröße. Dies ist die maximale Größe einer Nachricht, die vom Host gesendet oder empfangen werden kann. Bei Protokollen, die keine Nachrichtenrahmen unterstützen, kann die tatsächliche maximale Größe einer Nachricht, die an eine bestimmte Adresse gesendet werden kann, kleiner als dieser Wert sein.

MessageOriented

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32_API| Windows Sockets-Strukturen| PROTOCOL_INFO|dwServiceFlags| XP_MESSAGE_ORIENTED")

Das Protokoll ist nachrichtenorientiert. Ein nachrichtenorientiertes Protokoll verwendet Datenpakete zum Übertragen von Informationen. Im Gegensatz dazu übertragen streamorientierte Protokolle Daten als kontinuierlichen Bytestrom.

MinimumAddressSize

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32_API| Windows Sockets-Strukturen| PROTOCOL_INFO|iMinSockAddr "), Einheiten ("Zeichen")

Mindestlänge einer Socketadresse, die vom Protokoll unterstützt wird.

Name

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: key, Override ("Name"), MappingStrings ("Win32_API| Windows Sockets-Strukturen| PROTOCOL_INFO|lpProtocol")

Name für das Protokoll.

Beispiel: "TCP/IP"

PseudoStreamOriented

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32_API| Windows Sockets-Strukturen| PROTOCOL_INFO|dwServiceFlags| XP_PSEUDO_STREAM")

Das Protokoll ist ein nachrichtenorientiertes Protokoll, das Datenpakete mit variabler Länge oder gestreamte Daten für alle Empfangsvorgänge empfangen kann. Diese optionale Funktion ist nützlich, wenn eine Anwendung nicht möchte, dass das Protokoll Nachrichten umrahmen soll und streamorientierte Merkmale erfordert. Bei TRUE ist das Protokoll pseudostreamorientiert.

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")

UnterstütztBroadcasting

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32_API| Windows Sockets-Strukturen| PROTOCOL_INFO|dwServiceFlags| XP_SUPPORTS_BROADCAST")

Das Protokoll unterstützt einen Mechanismus zum Senden von Nachrichten über das Netzwerk.

SupportsConnectData

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32_API| Windows Sockets-Strukturen| PROTOCOL_INFO|dwServiceFlags| XP_CONNECT_DATA")

Mit dem Protokoll können Daten über das Netzwerk verbunden werden.

SupportsDisconnectData

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32_API| Windows Sockets-Strukturen| PROTOCOL_INFO|dwServiceFlags| XP_DISCONNECT_DATA")

Mit dem Protokoll können Daten über das Netzwerk getrennt werden.

SupportsEncryption

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32_API| Windows Sockets-Strukturen| PROTOCOL_INFO|dwServiceFlags| XP_ENCRYPTS")

Das Protokoll unterstützt die Datenverschlüsselung.

SupportsExpeditedData

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32_API| Windows Sockets-Strukturen| PROTOCOL_INFO|dwServiceFlags| XP_EXPEDITED_DATA")

Das Protokoll unterstützt beschleunigte Daten (auch als dringende Daten bezeichnet) im Netzwerk. Beschleunigte Daten können die Flusssteuerung umgehen und Vorrang vor normalen Datenpaketen erhalten.

SupportsFragmentation

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32_API| Windows Sockets-Strukturen| PROTOCOL_INFO|dwServiceFlags| XP_FRAGMENTATION")

Das Protokoll unterstützt die Übertragung der Daten in Fragmenten. Die maximale Übertragungseinheit des physischen Netzwerks (Physical Network Maximum Transfer Unit, MTU) ist für Anwendungen ausgeblendet. Jeder Medientyp verfügt über eine maximale Framegröße, die nicht überschritten werden kann. Die Linkschicht ermittelt die MTU und meldet sie an die verwendeten Protokolle.

SupportsGracefulClosing

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32_API| Windows Sockets-Strukturen| PROTOCOL_INFO|dwServiceFlags| XP_GRACEFUL_CLOSE")

Das Protokoll unterstützt zweiphasige Schließvorgänge, die auch als "graceful close operations" bezeichnet werden. Andernfalls unterstützt das Protokoll nur abbruchende Close-Vorgänge.

SupportsGuaranteedBandwidth

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32_API| Windows Sockets-Strukturen| PROTOCOL_INFO|dwServiceFlags| XP_BANDWIDTH_ALLOCATION")

Das Protokoll verfügt über einen Mechanismus zum Einrichten und Verwalten einer Bandbreite.

UnterstütztMulticasting

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32_API| Windows Sockets-Strukturen| PROTOCOL_INFO|dwServiceFlags| XP_SUPPORTS_MULTICAST")

Das Protokoll unterstützt Multicasting.

SupportsQualityofService

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32_API| Windows Sockets-Strukturen| WSAPROTOCOL_INFO|dwServiceFlags1| XP1_QOS_SUPPORTED")

Das Protokoll kann QoS(Quality of Service) vom zugrunde liegenden mehrschichtigen Dienstanbieter oder Transportanbieter unterstützen. QoS ist eine Sammlung von Komponenten, die eine Differenzierung und Vorzugsbehandlung für Teilmengen von Daten ermöglichen, die über das Netzwerk übertragen werden. QoS bedeutet, dass Teilmengen von Daten beim Durchlaufen eines Netzwerks eine höhere Priorität oder einen garantierten Dienst erhalten.

Bemerkungen

Die Win32_NetworkProtocol-Klasse wird von CIM_LogicalElement abgeleitet.

Beispiele

Im folgenden VBScript-Codebeispiel wird veranschaulicht, wie Eine Liste ausgeführter Dienste aus Instanzen von Win32_NetworkProtocol abgerufen wird.

Set ProtocolSet = GetObject("winmgmts:").ExecQuery("select * from Win32_NetworkProtocol")

for each Protocol in ProtocolSet
 WScript.Echo Protocol.Name
next

Im folgenden Perl-Codebeispiel wird veranschaulicht, wie Eine Liste ausgeführter Dienste aus Instanzen von Win32_NetworkProtocol abgerufen wird.

use strict;
use Win32::OLE;

my ( $ProtocolSet, $Protocol );

eval { $ProtocolSet = Win32::OLE->GetObject("winmgmts:{impersonationLevel=impersonate}!\\\\.\\root\\cimv2")->
 ExecQuery("SELECT * FROM Win32_NetworkProtocol"); };
unless($@)
{
 print "\n";
 foreach $Protocol (in $ProtocolSet) 
 {
  print $Protocol->{Name}, "\n";
 }
}
else
{
 print STDERR Win32::OLE->LastError, "\n";
}

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