Win32 _ NetworkProtocol-Klasse

Die _ WMI-Klasse Win32 NetworkProtocol stellt ein Protokoll und seine Netzwerkmerkmale 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 sind in alphabetischer Reihenfolge und 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;
};

Members

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: boolescher Wert

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32 _ API Windows | Sockets Structures PROTOCOL INFO | _ | dwServiceFlags | XP1 _ CONNECTIONLESS")

Das Protokoll unterstützt den verbindungslosen Dienst. Ein verbindungsloser (Datagramm)-Dienst beschreibt ein Kommunikationsprotokoll oder einen Transport, bei dem Datenpakete unabhängig voneinander geroutet werden und möglicherweise unterschiedlichen Routen folgen und in einer anderen Reihenfolge als die, in der sie gesendet wurden, eintreffen. Umgekehrt stellt ein verbindungsorientierter Dienst eine virtuelle Verbindung zur Verfügung, über die Datenpakete in derselben 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.

GuaranteesDelivery

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32 _ API Windows | Sockets Structures 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 beabsichtigte Ziel erreichen.

GuaranteesSequencing

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32 _ API Windows | Sockets Structures PROTOCOL INFO | _ | dwServiceFlags | XP _ GUARANTEED _ ORDER")

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

InstallDate

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("MIF. DMTF | ComponentID | 001.5"), DisplayName ("Installation date")

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.

MaximumAddressSize

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32 _ API Windows | Sockets Structures PROTOCOL INFO | _ | iMaxSockAddr"), Einheiten ("Zeichen")

Maximale Länge einer vom Protokoll unterstützten Socketadresse. 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 Structures PROTOCOL INFO | _ | dwMessageSize"), Einheiten ("Zeichen")

Maximale nachrichtengröße, die vom Protokoll unterstützt wird. Dies ist die maximale Größe einer Nachricht, die vom Host gesendet oder vom Host empfangen werden kann. Bei Protokollen, die kein 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: boolescher Wert

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32 _ API Windows | Sockets Structures PROTOCOL INFO | _ | dwServiceFlags | XP MESSAGE _ _ ORIENTED")

Das Protokoll ist nachrichtenorientiert. Ein nachrichtenorientiertes Protokoll verwendet Datenpakete, um Informationen zu übertragen. Im Gegensatz dazu übertragen streamorientierte Protokolle Daten als kontinuierlichen Bytedatenstrom.

MinimumAddressSize

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32 _ API Windows | Sockets Structures PROTOCOL INFO | _ | iMinSockAddr "), Units ("characters")

Mindestlänge einer vom Protokoll unterstützten Socketadresse.

Name

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Key, Override ("Name"), MappingStrings ("Win32 _ API Windows | Sockets Structures PROTOCOL INFO | _ | lpProtocol")

Name für das Protokoll.

Beispiel: "TCP/IP"

PseudoStreamOriented

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32 _ API Windows | Sockets Structures PROTOCOL INFO | _ | dwServiceFlags | XP PSEUDO _ _ STREAM")

Protocol ist ein nachrichtenorientiertes Protokoll, das Datenpakete 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 kann und streamorientierte Merkmale erfordert. True gibt an, dass das Protokoll pseudostreamorientiert ist.

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

SupportsBroadcasting

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32 _ API Windows | Sockets Structures PROTOCOL INFO | _ | dwServiceFlags | XP SUPPORTS _ _ BROADCAST")

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

SupportsConnectData

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32 _ API Windows | Sockets Structures PROTOCOL INFO | _ | dwServiceFlags | XP CONNECT _ _ DATA")

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

SupportsDisconnectData

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32 _ API Windows | Sockets Structures PROTOCOL INFO | _ | dwServiceFlags | XP DISCONNECT _ _ DATA")

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

SupportsEncryption

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32 _ API Windows | Sockets Structures PROTOCOL INFO | _ | dwServiceFlags | XP _ ENCRYPTS")

Das Protokoll unterstützt die Datenverschlüsselung.

SupportsExpeditedData

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32 _ API Windows | Sockets Structures PROTOCOL INFO | _ | dwServiceFlags | XP _ EXPEDITED _ DATA")

Das Protokoll unterstützt beschleunigte Daten (auch als dringende Daten bezeichnet) im gesamten Netzwerk. Beschleunigte Daten können die Flusssteuerung umgehen und Priorität gegenüber normalen Datenpaketen erhalten.

SupportsFragmentation

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32 _ API Windows | Sockets Structures PROTOCOL INFO | _ | dwServiceFlags | XP _ FRAGMENTATION")

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

SupportsGracefulClosing

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32 _ API Windows | Sockets Structures PROTOCOL INFO | _ | dwServiceFlags | XP _ GRACEFUL _ CLOSE")

Das Protokoll unterstützt 2-Phasen-Schlussvorgänge, die auch als "ordnungsgemäß schließende Vorgänge" bezeichnet werden. Falls nicht, unterstützt das Protokoll nur abortive Close-Vorgänge.

SupportsGuaranteedBandwidth

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32 _ API Windows | Sockets Structures PROTOCOL INFO | _ | dwServiceFlags | XP BANDWIDTH _ _ ALLOCATION")

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

SupportsMulticasting

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32 _ API Windows | Sockets Structures PROTOCOL INFO | _ | dwServiceFlags | XP SUPPORTS _ _ MULTICAST")

Das Protokoll unterstützt Multicasting.

SupportsQualityofService

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32 _ API Windows | Sockets Structures | WSAPROTOCOL _ INFO | dwServiceFlags1 | XP1 _ QOS _ SUPPORTED")

Das Protokoll kann Quality of Service (QoS) vom zugrunde liegenden mehrschichtigen Dienstanbieter oder Transportanbieter unterstützt werden. QoS ist eine Sammlung von Komponenten, die eine Unterscheidung und eine bevorzugte Behandlung von 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 der ausgeführten 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 der ausgeführten 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";
}

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