classe Win32_NetworkProtocol

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

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

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

Confira também

CIM_LogicalElement

Classes do sistema operacional