classe Win32_NetworkProtocol

  • Articolo

La classe WMIWin32_NetworkProtocol rappresenta un protocollo e le relative caratteristiche di rete in un sistema computer Win32.

La sintassi seguente è semplificata dal codice MOF (Managed Object Format) e include tutte le proprietà ereditate. Le proprietà e i metodi sono in ordine alfabetico, non in ordine MOF.

Sintassi

[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

La classe Win32_NetworkProtocol ha questi tipi di membri:

Proprietà

La classe Win32_NetworkProtocol ha queste proprietà.

Didascalia

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MaxLen (64), DisplayName ("Caption")

Breve descrizione testuale dell'oggetto.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

ConnectionlessService

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32_API| Strutture Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP1_CONNECTIONLESS")

Il protocollo supporta il servizio senza connessione. Un servizio senza connessione (datagram) descrive un protocollo di comunicazione o un trasporto in cui i pacchetti di dati vengono instradati indipendentemente l'uno dall'altro e possono seguire route diverse e arrivare in un ordine diverso da quello in cui sono stati inviati. Al contrario, un servizio orientato alla connessione fornisce un circuito virtuale tramite il quale i pacchetti di dati vengono ricevuti nello stesso ordine in cui sono stati trasmessi. Se la connessione tra computer ha esito negativo, l'applicazione riceve una notifica.

Descrizione

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: DisplayName ("Description")

Descrizione testuale dell'oggetto.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

GuaranteesDelivery

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32_API| Strutture Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_GUARANTEED_DELIVERY")

Il protocollo supporta il recapito di pacchetti di dati. Se questo flag è FALSE, è incerto che tutti i dati inviati raggiungano la destinazione prevista.

GaranzieSequenziamento

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32_API| Strutture Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_GUARANTEED_ORDER")

Il protocollo garantisce che i dati arrivino nell'ordine in cui è stato inviato. Tenere presente che questa caratteristica non garantisce il recapito dei dati, ma solo l'ordine.

InstallDate

Tipo di dati: datetime

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Data di installazione")

Indica quando l'oggetto è stato installato. La mancanza di un valore non indica che l'oggetto non è installato.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

MaximumAddressSize

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32_API| Strutture Windows Sockets | PROTOCOL_INFO|iMaxSockAddr"), unità ("caratteri")

Lunghezza massima di un indirizzo socket supportato dal protocollo. Gli indirizzi socket possono essere elementi, ad esempio un URL (www.microsoft.com) o un indirizzo IP (130.215.24.1).

MaximumMessageSize

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32_API| Strutture Windows Sockets | PROTOCOL_INFO|dwMessageSize"), unità ("caratteri")

Dimensioni massime dei messaggi supportate dal protocollo. Questa è la dimensione massima di un messaggio che può essere inviato o ricevuto dall'host. Per i protocolli che non supportano il frame dei messaggi, la dimensione massima effettiva di un messaggio che può essere inviato a un determinato indirizzo può essere minore di questo valore.

MessageOriented

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32_API| Strutture Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_MESSAGE_ORIENTED")

Il protocollo è orientato ai messaggi. Un protocollo orientato ai messaggi usa pacchetti di dati per trasferire informazioni. Al contrario, i protocolli orientati ai flussi trasferisce i dati come flusso continuo di byte.

MinimumAddressSize

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32_API| Strutture Windows Sockets | PROTOCOL_INFO|iMinSockAddr "), unità ("caratteri")

Lunghezza minima di un indirizzo socket supportato dal protocollo.

Nome

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: key, Override ("Name"), MappingStrings ("Win32_API| Strutture Windows Sockets | PROTOCOL_INFO|lpProtocol")

Nome del protocollo.

Esempio: "TCP/IP"

PseudoStreamOriented

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32_API| Strutture Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_PSEUDO_STREAM")

Il protocollo è un protocollo orientato ai messaggi che può ricevere pacchetti di dati a lunghezza variabile o dati trasmessi per tutte le operazioni di ricezione. Questa funzionalità facoltativa è utile quando un'applicazione non vuole che il protocollo frame i messaggi e richieda caratteristiche orientate al flusso. Se TRUE, il protocollo è pseudo stream-oriented.

Status

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MaxLen (10), DisplayName ("Status")

Stringa che indica lo stato corrente dell'oggetto. È possibile definire lo stato operativo e non operativo. Lo stato operativo può includere "OK", "Degraded" e "Pred Fail". "Pred Fail" indica che un elemento funziona correttamente, ma prevede un errore (ad esempio, un'unità disco rigido abilitata per SMART).

Lo stato non operativo può includere "Error", "Starting", "Stopping" e "Service". Il "servizio" può essere applicato durante il ridimensionamento del mirroring del disco, ricaricando un elenco di autorizzazioni utente o altre operazioni amministrative. Non tutto questo lavoro è online, ma l'elemento gestito non è né "OK" né in uno degli altri stati.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Sono inclusi i valori seguenti:

OK ("OK ")

Errore ("Errore")

Degradato ("degradato ")

Sconosciuto ("sconosciuto ")

Pred Fail ("Pred Fail ")

Avvio ("Avvio ")

Arresto ("Arresto")

Servizio ("Servizio ")

Sottolineato ("stressato ")

NonRecover ("NonRecover ")

Nessun contatto ("Nessun contatto ")

Lost Comm ("Lost Comm ")

SupportBroadcasting

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32_API| Strutture di Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_SUPPORTS_BROADCAST")

Il protocollo supporta un meccanismo per la trasmissione di messaggi in rete.

SupportConnectData

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32_API| Strutture di Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_CONNECT_DATA")

Il protocollo consente la connessione dei dati all'interno della rete.

SupportDisconnectData

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32_API| Strutture di Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_DISCONNECT_DATA")

Il protocollo consente la disconnessione dei dati nella rete.

SupportEncryption

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32_API| Strutture di Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_ENCRYPTS")

Il protocollo supporta la crittografia dei dati.

SupportExpeditedData

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32_API| Strutture di Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_EXPEDITED_DATA")

Il protocollo supporta i dati accelerati (noti anche come dati urgenti) nella rete. I dati accelerati possono ignorare il controllo del flusso e ricevere la priorità rispetto ai normali pacchetti di dati.

SupportFragmentation

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32_API| Strutture di Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_FRAGMENTATION")

Il protocollo supporta la trasmissione dei dati nei frammenti. L'unità di trasferimento massima rete fisica (MTU) è nascosta dalle applicazioni. Ogni tipo di supporto ha una dimensione massima del frame che non può essere superata. Il livello di collegamento individua l'MTU e lo segnala ai protocolli usati.

SupportGracefulClosing

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32_API| Strutture di Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_GRACEFUL_CLOSE")

Il protocollo supporta operazioni di chiusura a due fasi, note anche come "operazioni di chiusura grazia". In caso contrario, il protocollo supporta solo operazioni di chiusura interrotte.

SupportGuaranteedBandwidth

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32_API| Strutture di Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_BANDWIDTH_ALLOCATION")

Il protocollo ha un meccanismo per stabilire e mantenere una larghezza di banda.

SupportMulticasting

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32_API| Strutture di Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_SUPPORTS_MULTICAST")

Il protocollo supporta il multicast.

SupportQualityofService

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32_API| Strutture di Windows Sockets | WSAPROTOCOL_INFO|dwServiceFlags1| XP1_QOS_SUPPORTED")

Il protocollo è in grado di supportare qualità del servizio (QoS) dal provider di servizi a livelli sottostante o dal vettore di trasporto. QoS è una raccolta di componenti che consentono la differenziazione e il trattamento preferenziale per i subset di dati trasmessi attraverso la rete. QoS significa subset di dati ottenere una priorità superiore o un servizio garantito durante l'attraversamento di una rete.

Commenti

La classe Win32_NetworkProtocol deriva da CIM_LogicalElement.

Esempio

L'esempio di codice VBScript seguente illustra come recuperare un elenco di servizi in esecuzione da istanze di Win32_NetworkProtocol.

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

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

L'esempio di codice Perl seguente illustra come recuperare un elenco di servizi in esecuzione da istanze di 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";
}

Requisiti

Requisito Valore
Client minimo supportato
 Windows Vista
Server minimo supportato
 Windows Server 2008
Spazio dei nomi
 Radice\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Vedi anche

CIM_LogicalElement

Classi del sistema operativo