Win32_NetworkProtocol classe

  • Article

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

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

SupportsBroadcasting

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32_API| Structures Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_SUPPORTS_BROADCAST »)

Le protocole prend en charge un mécanisme de diffusion de messages sur le réseau.

SupportsConnectData

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32_API| Structures Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_CONNECT_DATA »)

Le protocole permet aux données d’être connectées sur le réseau.

SupportsDisconnectData

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32_API| Structures Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_DISCONNECT_DATA »)

Le protocole permet de déconnecter les données sur le réseau.

SupportsEncryption

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32_API| Structures Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_ENCRYPTS »)

Le protocole prend en charge le chiffrement des données.

SupportsExpeditedData

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32_API| Structures Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_EXPEDITED_DATA »)

Le protocole prend en charge les données accélérées (également appelées données urgentes) sur le réseau. Les données accélérées peuvent contourner le contrôle de flux et recevoir la priorité sur les paquets de données normaux.

SupportsFragmentation

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32_API| Structures Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_FRAGMENTATION »)

Le protocole prend en charge la transmission des données en fragments. L’unité de transfert maximale du réseau physique (MTU) est masquée des applications. Chaque type de média a une taille d’image maximale qui ne peut pas être dépassée. La couche de liens découvre la MTU et la signale aux protocoles utilisés.

SupportsGracefulClosing

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32_API| Structures Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_GRACEFUL_CLOSE »)

Le protocole prend en charge les opérations de fermeture en deux phases, également appelées « opérations de fermeture normale ». Si ce n’est pas le cas, le protocole prend uniquement en charge les opérations de fermeture abandonnées.

SupportsGuaranteedBandwidth

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32_API| Structures Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_BANDWIDTH_ALLOCATION »)

Le protocole dispose d’un mécanisme permettant d’établir et de gérer une bande passante.

SupportsMulticasting

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32_API| Structures Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_SUPPORTS_MULTICAST »)

Le protocole prend en charge la multidiffusion.

SupportsQualityofService

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32_API| Structures Windows Sockets | WSAPROTOCOL_INFO|dwServiceFlags1| XP1_QOS_SUPPORTED »)

Le protocole est capable de prendre en charge la qualité de service (QoS) par le fournisseur de services en couches sous-jacent ou le transporteur. QoS est une collection de composants qui permettent la différenciation et le traitement préférentiel pour les sous-ensembles de données transmises sur le réseau. QoS signifie que les sous-ensembles de données bénéficient d’une priorité plus élevée ou d’un service garanti lors de la traversée d’un réseau.

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

Condition requise Valeur
Client minimal pris en charge
 Windows Vista
Serveur minimal pris en charge
 Windows Server 2008
Espace de noms
 Racine\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Voir aussi

CIM_LogicalElement

Classes du système d’exploitation