Win32_NetworkProtocol classe

La classe WMIWin32_NetworkProtocol représente un protocole et ses caractéristiques réseau sur un système informatique Win32.

La syntaxe suivante est simplifiée par rapport au code MOF (Managed Object Format) et inclut toutes les propriétés héritées. Les propriétés et les méthodes sont dans l’ordre alphabétique, et non dans l’ordre MOF.

Syntaxe

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

Membres

La classe Win32_NetworkProtocol a les types de membres suivants :

• Propriétés

Propriétés

La classe Win32_NetworkProtocol possède ces propriétés.

Caption

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (64), DisplayName (« Caption »)

Brève description textuelle de l’objet.

Cette propriété est héritée de CIM_ManagedSystemElement.

ConnectionlessService

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32_API| Structures de sockets Windows | PROTOCOL_INFO|dwServiceFlags| XP1_CONNECTIONLESS »)

Le protocole prend en charge le service sans connexion. Un service sans connexion (datagramme) décrit un protocole de communication ou un transport dans lequel les paquets de données sont acheminés indépendamment les uns des autres et peuvent suivre des itinéraires différents et arriver dans un ordre différent de celui dans lequel ils ont été envoyés. À l’inverse, un service orienté connexion fournit un circuit virtuel via lequel les paquets de données sont reçus dans le même ordre qu’ils ont été transmis. Si la connexion entre les ordinateurs échoue, l’application est avertie.

Description

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Description »)

Description textuelle de l’objet.

Cette propriété est héritée de CIM_ManagedSystemElement.

GarantiesDelivery

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32_API| Structures de sockets Windows | PROTOCOL_INFO|dwServiceFlags| XP_GUARANTEED_DELIVERY »)

Le protocole prend en charge la remise de paquets de données. Si cet indicateur a la valeur FALSE, il n’est pas certain que toutes les données envoyées atteignent la destination prévue.

GarantiesSequencing

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32_API| Structures de sockets Windows | PROTOCOL_INFO|dwServiceFlags| XP_GUARANTEED_ORDER »)

Le protocole garantit que les données arriveront dans l’ordre dans lequel elles ont été envoyées. Sachez que cette caractéristique ne garantit pas la livraison des données, mais uniquement leur commande.

InstallDate

Type de données : datetime

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« MIF. DMTF| ComponentID|001.5 »), DisplayName (« Date d’installation »)

Indique quand l’objet a été installé. L’absence d’une valeur n’indique pas que l’objet n’est pas installé.

Cette propriété est héritée de CIM_ManagedSystemElement.

MaximumAddressSize

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32_API| Structures de sockets Windows | PROTOCOL_INFO|iMaxSockAddr »), unités (« caractères »)

Longueur maximale d’une adresse de socket prise en charge par le protocole. Les adresses de socket peuvent être des éléments tels qu’une URL (www.microsoft.com) ou une adresse IP (130.215.24.1).

MaximumMessageSize

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32_API| Structures de sockets Windows | PROTOCOL_INFO|dwMessageSize « ), unités (« caractères »)

Taille maximale du message prise en charge par le protocole. Il s’agit de la taille maximale d’un message qui peut être envoyé à partir de ou reçu par l’hôte. Pour les protocoles qui ne prennent pas en charge le cadrage des messages, la taille maximale réelle d’un message pouvant être envoyé à une adresse donnée peut être inférieure à cette valeur.

MessageOriented

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32_API| Structures de sockets Windows | PROTOCOL_INFO|dwServiceFlags| XP_MESSAGE_ORIENTED »)

Le protocole est orienté message. Un protocole orienté message utilise des paquets de données pour transférer des informations. À l’inverse, les protocoles orientés flux transfèrent des données sous la forme d’un flux continu d’octets.

MinimumAddressSize

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32_API| Structures de sockets Windows | PROTOCOL_INFO|iMinSockAddr « ), unités (« caractères »)

Longueur minimale d’une adresse de socket prise en charge par le protocole.

Nom

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : key, Override (« Name »), MappingStrings (« Win32_API| Structures de sockets Windows | PROTOCOL_INFO|lpProtocol »)

Nom du protocole.

Exemple : « TCP/IP »

PseudoStreamOriented

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32_API| Structures de sockets Windows | PROTOCOL_INFO|dwServiceFlags| XP_PSEUDO_STREAM »)

Le protocole est un protocole orienté message qui peut recevoir des paquets de données de longueur variable ou des données diffusées en continu pour toutes les opérations de réception. Cette fonctionnalité facultative est utile lorsqu’une application ne souhaite pas que le protocole encadre les messages et nécessite des caractéristiques orientées flux. Si la valeur est TRUE, le protocole est pseudo orienté flux.

État

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (10), DisplayName (« Status »)

Chaîne qui indique la status actuelle de l’objet. Il est possible de définir des status opérationnels et non opérationnels. Les status opérationnelles peuvent inclure « OK », « Détérioré » et « Échec anticipé ». « Échec anticipé » indique qu’un élément fonctionne correctement, mais qu’il prédit une défaillance (par exemple, un disque dur smart).

Les status non opérationnelles peuvent inclure « Error », « Starting », « Stopping » et « Service ». « Service » peut s’appliquer pendant la miroir disque, le rechargement d’une liste d’autorisations utilisateur ou tout autre travail administratif. Tous ces travaux ne sont pas en ligne, mais l’élément managé n’est ni « OK » ni dans l’un des autres états.

Cette propriété est héritée de CIM_ManagedSystemElement.

Les valeurs sont notamment les suivantes :

OK (« OK »)

Erreur (« Erreur »)

Détérioré (« Détérioré »)

Inconnu (« Inconnu »)

Échec de la préversion (« Échec prédé »)

Démarrage (« Démarrage »)

Arrêt (« Arrêt »)

Service (« Service »)

Stressé (« Stressé »)

NonRecover (« NonRecover »)

Aucun contact (« Aucun contact »)

Lost Comm (« Lost Comm »)

Notes

La classe Win32_NetworkProtocol est dérivée de CIM_LogicalElement.

Exemples

L’exemple de code VBScript suivant montre comment récupérer une liste de services en cours d’exécution à partir d’instances de Win32_NetworkProtocol.

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

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

L’exemple de code Perl suivant montre comment récupérer une liste de services en cours d’exécution à partir d’instances de Win32_NetworkProtocol.

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

Spécifications

Voir aussi

CIM_LogicalElement

Classes du système d’exploitation