classe Win32_NetworkProtocol

  • Artigo

A classe WMIWin32_NetworkProtocol representa um protocolo e suas características de rede em um sistema de computador Win32.

A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas. Propriedades e métodos estão em ordem alfabética, não em ordem MOF.

Sintaxe

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

Membros

A classe Win32_NetworkProtocol tem estes tipos de membros:

Propriedades

A classe Win32_NetworkProtocol tem essas propriedades.

Legenda

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

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

Uma breve descrição textual do objeto .

Essa propriedade é herdada de CIM_ManagedSystemElement.

ConnectionlessService

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32_API| Estruturas de soquetes do Windows| PROTOCOL_INFO|dwServiceFlags| XP1_CONNECTIONLESS")

O protocolo dá suporte ao serviço sem conexão. Um serviço sem conexão (datagrama) descreve um protocolo de comunicação ou transporte no qual os pacotes de dados são roteados independentemente uns dos outros e podem seguir rotas diferentes e chegar em uma ordem diferente daquela em que foram enviados. Por outro lado, um serviço orientado à conexão fornece um circuito virtual por meio do qual os pacotes de dados são recebidos na mesma ordem em que foram transmitidos. Se a conexão entre computadores falhar, o aplicativo será notificado.

Descrição

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: DisplayName ("Description")

Uma descrição textual do objeto .

Essa propriedade é herdada de CIM_ManagedSystemElement.

GuaranteesDelivery

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32_API| Estruturas de soquetes do Windows| PROTOCOL_INFO|dwServiceFlags| XP_GUARANTEED_DELIVERY")

O protocolo dá suporte à entrega de pacotes de dados. Se esse sinalizador for FALSE, é incerto que todos os dados enviados cheguem ao destino pretendido.

GarantiaSequencing

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32_API| Estruturas de soquetes do Windows| PROTOCOL_INFO|dwServiceFlags| XP_GUARANTEED_ORDER")

O protocolo garante que os dados cheguem na ordem em que foram enviados. Lembre-se de que essa característica não garante a entrega dos dados, apenas seu pedido.

InstallDate

Tipo de dados: datetime

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Data de Instalação")

Indica quando o objeto foi instalado. A falta de um valor não indica que o objeto não está instalado.

Essa propriedade é herdada de CIM_ManagedSystemElement.

MaximumAddressSize

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32_API| Estruturas de soquetes do Windows| PROTOCOL_INFO|iMaxSockAddr"), unidades ("caracteres")

Comprimento máximo de um endereço de soquete compatível com o protocolo. Os endereços de soquete podem ser itens como uma URL (www.microsoft.com) ou um endereço IP (130.215.24.1).

MaximumMessageSize

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32_API| Estruturas de soquetes do Windows| PROTOCOL_INFO|dwMessageSize"), unidades ("caracteres")

Tamanho máximo da mensagem compatível com o protocolo. Esse é o tamanho máximo de uma mensagem que pode ser enviada ou recebida pelo host. Para protocolos que não dão suporte ao enquadramento de mensagens, o tamanho máximo real de uma mensagem que pode ser enviada para um determinado endereço pode ser menor que esse valor.

MessageOriented

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32_API| Estruturas de soquetes do Windows| PROTOCOL_INFO|dwServiceFlags| XP_MESSAGE_ORIENTED")

O protocolo é orientado a mensagens. Um protocolo orientado a mensagens usa pacotes de dados para transferir informações. Por outro lado, os protocolos orientados a fluxo transferem dados como um fluxo contínuo de bytes.

MinimumAddressSize

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32_API| Estruturas de soquetes do Windows| PROTOCOL_INFO|iMinSockAddr "), unidades ("caracteres")

Comprimento mínimo de um endereço de soquete compatível com o protocolo.

Nome

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: chave, Substituição ("Nome"), MappingStrings ("Win32_API| Estruturas de soquetes do Windows| PROTOCOL_INFO|lpProtocol")

Nome do protocolo.

Exemplo: "TCP/IP"

PseudoStreamOriented

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32_API| Estruturas de soquetes do Windows| PROTOCOL_INFO|dwServiceFlags| XP_PSEUDO_STREAM")

O protocolo é um protocolo orientado a mensagens que pode receber pacotes de dados de comprimento variável ou dados transmitidos para todas as operações de recebimento. Essa capacidade opcional é útil quando um aplicativo não deseja que o protocolo enquadere mensagens e requer características orientadas a fluxo. Se TRUE, o protocolo será pseudo orientado a fluxo.

Status

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

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

Cadeia de caracteres que indica o status atual do objeto. As status operacionais e não operacionais podem ser definidas. Os status operacionais podem incluir "OK", "Degradado" e "Falha de Pred". "Pred Fail" indica que um elemento está funcionando corretamente, mas está prevendo uma falha (por exemplo, uma unidade de disco rígido habilitada para SMART).

As status não operacionais podem incluir "Erro", "Iniciando", "Parando" e "Serviço". O "Serviço" pode ser aplicado durante o disco espelho-resilvering, recarregando uma lista de permissões de usuário ou outro trabalho administrativo. Nem todo esse trabalho está online, mas o elemento gerenciado não é "OK" nem em um dos outros estados.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Os valores incluem o seguinte:

OK ("OK")

Erro ("Erro")

Degradado ("Degradado")

Desconhecido ("Desconhecido")

Pred Fail ("Pred Fail")

Iniciando ("Iniciando")

Parando ("Parando")

Serviço ("Serviço")

Estressado ("Estressado")

NonRecover ("NonRecover")

Sem Contato ("Sem Contato")

Lost Comm ("Lost Comm")

SupportsBroadcasting

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32_API| Estruturas do Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_SUPPORTS_BROADCAST")

O protocolo dá suporte a um mecanismo para transmitir mensagens pela rede.

SupportsConnectData

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32_API| Estruturas do Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_CONNECT_DATA")

O protocolo permite que os dados sejam conectados pela rede.

SupportsDisconnectData

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32_API| Estruturas do Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_DISCONNECT_DATA")

O protocolo permite que os dados sejam desconectados pela rede.

SupportsEncryption

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32_API| Estruturas do Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_ENCRYPTS")

O protocolo dá suporte à criptografia de dados.

SupportsExpeditedData

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32_API| Estruturas do Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_EXPEDITED_DATA")

O protocolo dá suporte a dados agilizados (também conhecidos como dados urgentes) em toda a rede. Os dados agilizados podem ignorar o controle de fluxo e receber prioridade sobre pacotes de dados normais.

SupportsFragmentation

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32_API| Estruturas do Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_FRAGMENTATION")

O protocolo dá suporte à transmissão dos dados em fragmentos. A MTU (unidade de transferência máxima) de rede física está oculta dos aplicativos. Cada tipo de mídia tem um tamanho máximo de quadro que não pode ser excedido. A camada de link descobre a MTU e a relata aos protocolos usados.

SupportsGracefulClosing

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32_API| Estruturas do Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_GRACEFUL_CLOSE")

O protocolo dá suporte a operações de fechamento em duas fases, também conhecidas como "operações de fechamento normal". Caso contrário, o protocolo dá suporte apenas a operações de fechamento abortivas.

SupportsGuaranteedBandwidth

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32_API| Estruturas do Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_BANDWIDTH_ALLOCATION")

O protocolo tem um mecanismo para estabelecer e manter uma largura de banda.

SupportsMulticasting

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32_API| Estruturas do Windows Sockets | PROTOCOL_INFO|dwServiceFlags| XP_SUPPORTS_MULTICAST")

O protocolo dá suporte a multicasting.

SupportsQualityofService

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32_API| Estruturas do Windows Sockets | WSAPROTOCOL_INFO|dwServiceFlags1| XP1_QOS_SUPPORTED")

O protocolo é capaz de dar suporte à QoS (Qualidade de Serviço) pelo provedor de serviços em camadas subjacente ou pela transportadora de transporte. A QoS é uma coleção de componentes que permitem diferenciação e tratamento preferencial para subconjuntos de dados transmitidos pela rede. QoS significa que subconjuntos de dados têm prioridade mais alta ou serviço garantido ao percorrer uma rede.

Comentários

A classe Win32_NetworkProtocol é derivada de CIM_LogicalElement.

Exemplos

O exemplo de código VBScript a seguir demonstra como recuperar uma lista de serviços em execução de instâncias de Win32_NetworkProtocol.

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

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

O exemplo de código Perl a seguir demonstra como recuperar uma lista de serviços em execução de instâncias 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 Valor
Cliente mínimo com suporte
 Windows Vista
Servidor mínimo com suporte
 Windows Server 2008
Namespace
 Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Confira também

CIM_LogicalElement

Classes do sistema operacional