Win32_NetworkProtocol clase

  • Artículo

LaWin32_NetworkProtocol clase WMI representa un protocolo y sus características de red en un sistema de equipo Win32.

La siguiente sintaxis se simplifica desde el código de Managed Object Format (MOF) e incluye todas las propiedades heredadas. Las propiedades y los métodos están en orden alfabético, no en orden MOF.

Sintaxis

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

Miembros

La clase Win32_NetworkProtocol tiene estos tipos de miembros:

Propiedades

La clase Win32_NetworkProtocol tiene estas propiedades.

Caption

Tipo de datos: cadena

Tipo de acceso: solo lectura

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

Descripción textual breve del objeto.

Esta propiedad se hereda de CIM_ManagedSystemElement.

ConnectionlessService

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32_API| Estructuras de Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP1_CONNECTIONLESS")

El protocolo admite el servicio sin conexión. Un servicio sin conexión (datagram) describe un protocolo de comunicaciones o un transporte en el que los paquetes de datos se enrutan de forma independiente entre sí y pueden seguir rutas diferentes y llegar en un orden diferente del que se enviaron. Por el contrario, un servicio orientado a la conexión proporciona un circuito virtual a través del cual se reciben paquetes de datos en el mismo orden en que se transmitieron. Si se produce un error en la conexión entre equipos, se notifica a la aplicación.

Descripción

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: DisplayName ("Descripción")

Descripción textual del objeto.

Esta propiedad se hereda de CIM_ManagedSystemElement.

GuaranteesDelivery

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32_API| Estructuras de Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_GUARANTEED_DELIVERY")

El protocolo admite la entrega de paquetes de datos. Si esta marca es FALSE, no se sabe que todos los datos enviados llegarán al destino previsto.

GarantíasSequencing

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32_API| Estructuras de Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_GUARANTEED_ORDER")

El protocolo garantiza que los datos lleguen en el orden en que se envió. Tenga en cuenta que esta característica no garantiza la entrega de los datos, solo su pedido.

InstallDate

Tipo de datos: datetime

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Fecha de instalación")

Indica cuándo se instaló el objeto. La falta de un valor no indica que el objeto no está instalado.

Esta propiedad se hereda de CIM_ManagedSystemElement.

MaximumAddressSize

Tipo de datos: uint32

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32_API| Estructuras de Windows Sockets | PROTOCOL_INFO|iMaxSockAddr"), unidades ("caracteres")

Longitud máxima de una dirección de socket compatible con el protocolo. Las direcciones de socket pueden ser elementos como una dirección URL (www.microsoft.com) o una dirección IP (130.215.24.1).

MaximumMessageSize

Tipo de datos: uint32

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32_API| Estructuras de Windows Sockets | PROTOCOL_INFO|dwMessageSize"), unidades ("caracteres")

Tamaño máximo de mensaje admitido por el protocolo. Este es el tamaño máximo de un mensaje que el host puede enviar o recibir. En el caso de los protocolos que no admiten tramas de mensajes, el tamaño máximo real de un mensaje que se puede enviar a una dirección determinada puede ser menor que este valor.

MessageOriented

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32_API| Estructuras de Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_MESSAGE_ORIENTED")

El protocolo está orientado a mensajes. Un protocolo orientado a mensajes usa paquetes de datos para transferir información. Por el contrario, los protocolos orientados a flujos transfieren datos como un flujo continuo de bytes.

MinimumAddressSize

Tipo de datos: uint32

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32_API| Estructuras de Windows Sockets | PROTOCOL_INFO|iMinSockAddr "), unidades ("caracteres")

Longitud mínima de una dirección de socket compatible con el protocolo.

Nombre

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: key, Override ("Name"), MappingStrings ("Win32_API| Estructuras de Windows Sockets | PROTOCOL_INFO|lpProtocol")

Nombre del protocolo.

Ejemplo: "TCP/IP"

PseudoStreamOriented

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32_API| Estructuras de Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_PSEUDO_STREAM")

El protocolo es un protocolo orientado a mensajes que puede recibir paquetes de datos de longitud variable o datos transmitidos para todas las operaciones de recepción. Esta capacidad opcional es útil cuando una aplicación no quiere que el protocolo marco los mensajes y requiera características orientadas a flujos. Si es TRUE, el protocolo está orientado a secuencias.

Estado

Tipo de datos: cadena

Tipo de acceso: solo lectura

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

Cadena que indica el estado actual del objeto. Se puede definir el estado operativo y no operativo. El estado operativo puede incluir "Aceptar", "Degradado" y "Error previo". "Error previo" indica que un elemento funciona correctamente, pero predice un error (por ejemplo, una unidad de disco duro habilitada para SMART).

El estado no operativo puede incluir "Error", "Inicio", "Detención" y "Servicio". "Servicio" se puede aplicar durante el resilvering de reflejo del disco, volver a cargar una lista de permisos de usuario u otro trabajo administrativo. No todo este trabajo está en línea, pero el elemento administrado no es "OK" ni en uno de los otros estados.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Los valores son los siguientes:

Ok ("OK")

Error ("Error")

Degradado ("Degradado")

Desconocido ("Desconocido")

Error previo ("Error previo")

Inicio ("Inicio")

Detener ("Detener")

Servicio ("Servicio")

Estresado ("Estresado")

NonRecover ("NonRecover")

Sin contacto ("Sin contacto")

Lost Comm ("Lost Comm")

SupportsBroadcasting

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32_API| Estructuras de Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_SUPPORTS_BROADCAST")

El protocolo admite un mecanismo para difundir mensajes a través de la red.

SupportsConnectData

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32_API| Estructuras de Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_CONNECT_DATA")

El protocolo permite que los datos se conecten a través de la red.

SupportsDisconnectData

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32_API| Estructuras de Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_DISCONNECT_DATA")

El protocolo permite desconectar los datos a través de la red.

SupportsEncryption

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32_API| Estructuras de Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_ENCRYPTS")

El protocolo admite el cifrado de datos.

SupportsExpeditedData

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32_API| Estructuras de Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_EXPEDITED_DATA")

El protocolo admite datos acelerados (también conocidos como datos urgentes) a través de la red. Los datos acelerados pueden omitir el control de flujo y recibir prioridad sobre los paquetes de datos normales.

SupportsFragmentation

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32_API| Estructuras de Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_FRAGMENTATION")

El protocolo admite la transmisión de los datos en fragmentos. La unidad de transferencia máxima de red física (MTU) está oculta de las aplicaciones. Cada tipo de medio tiene un tamaño máximo de marco que no se puede superar. La capa de vínculo detecta la MTU y la informa de los protocolos usados.

SupportsGracefulClosing

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32_API| Estructuras de Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_GRACEFUL_CLOSE")

El protocolo admite operaciones de cierre en dos fases, también conocidas como "operaciones de cierre correctas". Si no es así, el protocolo solo admite operaciones de cierre anulativas.

SupportsGuaranteedBandwidth

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32_API| Estructuras de Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_BANDWIDTH_ALLOCATION")

El protocolo tiene un mecanismo para establecer y mantener un ancho de banda.

SupportsMulticasting

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32_API| Estructuras de Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_SUPPORTS_MULTICAST")

El protocolo admite la multidifusión.

SupportsQualityofService

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32_API| Estructuras de Windows Sockets | WSAPROTOCOL_INFO|dwServiceFlags1| XP1_QOS_SUPPORTED")

El protocolo es capaz de admitir la calidad de servicio (QoS) por parte del proveedor de servicios en capas subyacente o del transportista. QoS es una colección de componentes que permiten la diferenciación y el tratamiento preferencial para subconjuntos de datos transmitidos a través de la red. QoS significa que los subconjuntos de datos obtienen una prioridad más alta o un servicio garantizado al atravesar una red.

Comentarios

La clase Win32_NetworkProtocol se deriva de CIM_LogicalElement.

Ejemplos

En el ejemplo de código de VBScript siguiente se muestra cómo recuperar una lista de servicios en ejecución de instancias de Win32_NetworkProtocol.

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

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

En el ejemplo de código perl siguiente se muestra cómo recuperar una lista de servicios en ejecución de instancias 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";
}

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows Vista
Servidor mínimo compatible
 Windows Server 2008
Espacio de nombres
 Root\CIMV2
MOF
CIMWin32.mof
Archivo DLL
CIMWin32.dll

Consulte también

CIM_LogicalElement

Clases de sistema operativo