Win32_NetworkProtocol-Klasse

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

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

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

Siehe auch

CIM_LogicalElement

Betriebssystemklassen