класс Win32_NetworkProtocol

Статья
06/12/2023

Класс WMIWin32_NetworkProtocol представляет протокол и его сетевые характеристики в компьютерной системе Win32.

Следующий пример синтаксиса — упрощенный MOF-код, который включает все наследуемые свойства. Свойства и методы находятся в алфавитном порядке, а не в порядке MOF.

Синтаксис

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

Члены

Класс Win32_NetworkProtocol имеет следующие типы членов:

Свойства

Элемент Property

Класс Win32_NetworkProtocol имеет эти свойства.

Caption

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MaxLen (64), DisplayName ("Caption")

Краткое текстовое описание объекта.

Это свойство наследуется от CIM_ManagedSystemElement.

Служба без подключения

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32_API| Структуры сокетов Windows | PROTOCOL_INFO|dwServiceFlags| XP1_CONNECTIONLESS")

Протокол поддерживает службу без подключения. Служба без подключения (датаграмма) описывает протокол связи или транспорт, в котором пакеты данных маршрутизуются независимо друг от друга и могут следовать по разным маршрутам и поступать в порядке, отличном от того, в котором они были отправлены. И наоборот, служба, ориентированная на подключение, предоставляет виртуальный канал, через который пакеты данных получаются в том же порядке, в котором они были переданы. Если подключение между компьютерами завершается сбоем, приложение получает уведомление.

Описание

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: DisplayName ("Описание")

Текстовое описание объекта.

Это свойство наследуется от CIM_ManagedSystemElement.

GuaranteesDelivery

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32_API| Структуры сокетов Windows | PROTOCOL_INFO|dwServiceFlags| XP_GUARANTEED_DELIVERY")

Протокол поддерживает доставку пакетов данных. Если этот флаг имеет значение FALSE, нет сомнения в том, что все отправленные данные достигнут предполагаемого назначения.

ГарантииSequencing

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32_API| Структуры сокетов Windows | PROTOCOL_INFO|dwServiceFlags| XP_GUARANTEED_ORDER")

Протокол гарантирует, что данные будут поступать в том порядке, в котором они были отправлены. Имейте в виду, что эта характеристика не обеспечивает доставку данных, а только их порядок.

InstallDate

Тип данных: datetime
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Дата установки")

Указывает, когда был установлен объект . Отсутствие значения не означает, что объект не установлен.

Это свойство наследуется от CIM_ManagedSystemElement.

MaximumAddressSize

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32_API| Структуры сокетов Windows | PROTOCOL_INFO|iMaxSockAddr"), единицы измерения ("символы")

Максимальная длина адреса сокета, поддерживаемая протоколом. Адреса сокетов могут быть такими элементами, как URL-адрес (www.microsoft.com) или IP-адрес (130.215.24.1).

MaximumMessageSize

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32_API| Структуры сокетов Windows | PROTOCOL_INFO|dwMessageSize"), единицы измерения ("символы")

Максимальный размер сообщения, поддерживаемый протоколом. Это максимальный размер сообщения, которое может быть отправлено или получено узлом. Для протоколов, которые не поддерживают кадрирование сообщений, фактический максимальный размер сообщения, которое может быть отправлено на заданный адрес, может быть меньше этого значения.

MessageOriented

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32_API| Структуры сокетов Windows | PROTOCOL_INFO|dwServiceFlags| XP_MESSAGE_ORIENTED")

Протокол ориентирован на сообщения. Протокол, ориентированный на сообщения, использует пакеты данных для передачи информации. И наоборот, протоколы, ориентированные на поток, передают данные в виде непрерывного потока байтов.

MinimumAddressSize

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32_API| Структуры сокетов Windows | PROTOCOL_INFO|iMinSockAddr "), единицы измерения ("символы")

Минимальная длина адреса сокета, поддерживаемого протоколом.

имя;

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: key, Override ("Name"), MappingStrings ("Win32_API| Структуры сокетов Windows | PROTOCOL_INFO|lpProtocol")

Имя протокола.

Пример: "TCP/IP"

PseudoStreamOriented

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32_API| Структуры сокетов Windows | PROTOCOL_INFO|dwServiceFlags| XP_PSEUDO_STREAM")

Протокол — это протокол, ориентированный на сообщения, который может получать пакеты данных переменной длины или потоковые данные для всех операций получения. Эта необязательная возможность полезна, если приложение не хочет, чтобы протокол обрамлял сообщения и требует характеристики потоковой передачи. Если задано значение TRUE, протокол является псевдопотоково-ориентированным.

Состояние

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MaxLen (10), DisplayName ("Status")

Строка, указывающая текущее состояние объекта. Можно определить рабочее и нерабочем состояние. Состояние работы может включать "ОК", "Понижено" и "Сбой предварительного выполнения". "Pred Fail" означает, что элемент работает правильно, но прогнозирует сбой (например, жесткий диск с поддержкой SMART).

Состояние нерабоспособных может включать "Ошибка", "Запуск", "Остановка" и "Служба". "Служба" может применяться во время зеркало повторного изменения размера диска, перезагрузки списка разрешений пользователя или других административных действий. Не все такие работы доступны в сети, но управляемый элемент не является ни "ОК", ни в одном из других состояний.

Это свойство наследуется от CIM_ManagedSystemElement.

В эти значения входят:

ОК ("ОК")

Error ("Error")

Пониженный ("Пониженный")

Unknown ("Unknown")

Pred Fail ("Pred Fail")

Запуск ("Запуск")

Остановка ("Остановка")

Служба ("Служба")

Подчеркнуто ("подчеркнуто")

NonRecover ("NonRecover")

Нет контакта ("Нет контакта")

Lost Comm ("Lost Comm")

SupportsBroadcasting

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32_API| Структуры сокетов Windows | PROTOCOL_INFO|dwServiceFlags| XP_SUPPORTS_BROADCAST")

Протокол поддерживает механизм трансляции сообщений по сети.

SupportsConnectData

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32_API| Структуры сокетов Windows | PROTOCOL_INFO|dwServiceFlags| XP_CONNECT_DATA")

Протокол позволяет подключать данные по сети.

SupportsDisconnectData

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32_API| Структуры сокетов Windows | PROTOCOL_INFO|dwServiceFlags| XP_DISCONNECT_DATA")

Протокол позволяет отключать данные по сети.

SupportsEncryption

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32_API| Структуры сокетов Windows | PROTOCOL_INFO|dwServiceFlags| XP_ENCRYPTS")

Протокол поддерживает шифрование данных.

SupportsExpeditedData

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32_API| Структуры сокетов Windows | PROTOCOL_INFO|dwServiceFlags| XP_EXPEDITED_DATA")

Протокол поддерживает ускоренную передачу данных (также известных как срочные данные) по сети. Ускоренная обработка данных может обойти управление потоком и получить приоритет над обычными пакетами данных.

SupportsFragmentation

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32_API| Структуры сокетов Windows | PROTOCOL_INFO|dwServiceFlags| XP_FRAGMENTATION")

Протокол поддерживает передачу данных фрагментами. Максимальная единица передачи физической сети (MTU) скрыта от приложений. Каждый тип мультимедиа имеет максимальный размер кадра, который не может быть превышен. Уровень связи обнаруживает MTU и сообщает об этом используемым протоколам.

SupportsGracefulClosing

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32_API| Структуры сокетов Windows | PROTOCOL_INFO|dwServiceFlags| XP_GRACEFUL_CLOSE")

Протокол поддерживает двухфазные операции закрытия, также называемые "корректной операцией закрытия". В противном случае протокол поддерживает только прерванные операции закрытия.

SupportsGuaranteedBandwidth

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32_API| Структуры сокетов Windows | PROTOCOL_INFO|dwServiceFlags| XP_BANDWIDTH_ALLOCATION")

Протокол имеет механизм для установки и поддержания пропускной способности.

SupportsMulticasting

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32_API| Структуры сокетов Windows | PROTOCOL_INFO|dwServiceFlags| XP_SUPPORTS_MULTICAST")

Протокол поддерживает многоадресную рассылку.

SupportsQualityofService

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32_API| Структуры сокетов Windows | WSAPROTOCOL_INFO|dwServiceFlags1| XP1_QOS_SUPPORTED")

Протокол поддерживает качество обслуживания (QoS) базового многоуровневого поставщика услуг или транспортного перевозчика. QoS — это набор компонентов, которые обеспечивают дифференциацию и привилегированный режим для подмножеств данных, передаваемых по сети. QoS означает, что подмножества данных получают более высокий приоритет или гарантированную службу при обходе сети.

Примеры

В следующем примере кода VBScript показано, как получить список запущенных служб из экземпляров Win32_NetworkProtocol.

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

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

В следующем примере кода Perl показано, как получить список запущенных служб из экземпляров 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";
}

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Пространство имен	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

См. также раздел

CIM_LogicalElement
Классы операционной системы

класс Win32_NetworkProtocol

Синтаксис

Члены

Элемент Property

Комментарии

Примеры

Требования

См. также раздел

Обратная связь

Обратная связь

Дополнительные ресурсы