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.1sein. -
-
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 |
|
| DLL |
|