Win32_NetworkProtocol 类

项目
06/12/2023

Win32_NetworkProtocolWMI 类表示 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 类具有以下类型的成员：

属性

属性

Win32_NetworkProtocol 类具有以下属性。

Caption

数据类型： 字符串
访问类型：只读
限定符： MaxLen (64) 、 DisplayName (“Caption”)

对象的简短文本说明。

此属性继承自 CIM_ManagedSystemElement。

ConnectionlessService

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32_API|Windows 套接字结构 |PROTOCOL_INFO|dwServiceFlags |XP1_CONNECTIONLESS“)

协议支持无连接服务。无连接 (数据报) 服务描述了一种通信协议或传输，在该协议或传输中，数据包相互独立路由，并可能遵循不同的路由，并按与发送它们的顺序不同的顺序到达。相反，面向连接的服务提供虚拟线路，通过该线路接收数据包的顺序与传输顺序相同。如果计算机之间的连接失败，应用程序会收到通知。

描述

数据类型： 字符串
访问类型：只读
限定符： DisplayName (“Description”)

对象的文本说明。

此属性继承自 CIM_ManagedSystemElement。

GuaranteesDelivery

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32_API|Windows 套接字结构 |PROTOCOL_INFO|dwServiceFlags |XP_GUARANTEED_DELIVERY“)

协议支持传送数据包。如果此标志为 FALSE，则不确定发送的所有数据都将到达预期目标。

GuaranteesSequencing

数据类型： 布尔值
访问类型：只读
限定符： 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“) ，单位 (”characters“)

协议支持的套接字地址的最大长度。套接字地址可以是诸如 URL () www.microsoft.com 或 IP 地址等项， () 130.215.24.1 。

MaximumMessageSize

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“Win32_API|Windows 套接字结构 |PROTOCOL_INFO|dwMessageSize“) ，单位 (”characters“)

协议支持的最大消息大小。这是主机可以发送或接收的消息的最大大小。对于不支持消息帧的协议，可发送到给定地址的消息的实际最大大小可能小于此值。

MessageOriented

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32_API|Windows 套接字结构 |PROTOCOL_INFO|dwServiceFlags |XP_MESSAGE_ORIENTED“)

协议面向消息。面向消息的协议使用数据包来传输信息。相反，面向流的协议将数据传输为连续的字节流。

MinimumAddressSize

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“Win32_API|Windows 套接字结构 |PROTOCOL_INFO|iMinSockAddr “) ，单位 (”字符“)

协议支持的套接字地址的最小长度。

名称

数据类型： 字符串
访问类型：只读
限定符： key、 Override (“Name”) 、 MappingStrings (“Win32_API|Windows 套接字结构 |PROTOCOL_INFO|lpProtocol“)

协议的名称。

示例：“TCP/IP”

PseudoStreamOriented

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32_API|Windows 套接字结构 |PROTOCOL_INFO|dwServiceFlags |XP_PSEUDO_STREAM“)

协议是一种面向消息的协议，可以接收所有接收操作的可变长度数据包或流数据。当应用程序不希望协议对消息进行帧化并且需要面向流的特征时，此可选功能非常有用。如果 为 TRUE，则协议面向伪流。

Status

数据类型： 字符串
访问类型：只读
限定符： MaxLen (10) 、 DisplayName (“Status”)

指示对象的当前状态的字符串。可以定义操作状态和非操作状态。操作状态可能包括“正常”、“降级”和“预失败”。 “Pred Fail”表示某个元素正常运行，但预测故障 (例如启用 SMART 的硬盘驱动器) 。

非操作状态可能包括“错误”、“正在启动”、“正在停止”和“服务”。 “服务”可以在磁盘镜像重新同步、重新加载用户权限列表或其他管理工作期间应用。并非所有此类工作都联机，但托管元素既不是“正常”，也不是处于其他状态之一。

此属性继承自 CIM_ManagedSystemElement。

包括以下值：

OK (“OK”)

错误 (“错误”)

降级 (“已降级”)

未知 (“未知”)

Pred Fail (“Pred Fail”)

starting (“Starting”)

停止 (“停止”)

服务 (“服务”)

压力 (“有压力”)

NonRecover (“NonRecover”)

无联系人 (“无联系人”)

Lost Comm (“Lost Comm”)

SupportsBroadcasting

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32_API|Windows 套接字结构 |PROTOCOL_INFO|dwServiceFlags |XP_SUPPORTS_BROADCAST“)

协议支持跨网络广播消息的机制。

SupportsConnectData

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32_API|Windows 套接字结构 |PROTOCOL_INFO|dwServiceFlags |XP_CONNECT_DATA“)

协议允许跨网络连接数据。

SupportsDisconnectData

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32_API|Windows 套接字结构 |PROTOCOL_INFO|dwServiceFlags |XP_DISCONNECT_DATA“)

协议允许跨网络断开数据连接。

SupportsEncryption

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32_API|Windows 套接字结构 |PROTOCOL_INFO|dwServiceFlags |XP_ENCRYPTS“)

协议支持数据加密。

SupportsExpeditedData

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32_API|Windows 套接字结构 |PROTOCOL_INFO|dwServiceFlags |XP_EXPEDITED_DATA“)

协议支持加速数据 (也称为跨网络紧急数据) 。加速数据可以绕过流控制，接收优先级超过正常数据包。

SupportsFragmentation

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32_API|Windows 套接字结构 |PROTOCOL_INFO|dwServiceFlags |XP_FRAGMENTATION“)

协议支持在片段中传输数据。物理网络最大传输单元 (MTU) 对应用程序隐藏。每种媒体类型都有一个不能超过的最大帧大小。链接层会发现 MTU 并将其报告给使用的协议。

SupportsGracefulClosing

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32_API|Windows 套接字结构 |PROTOCOL_INFO|dwServiceFlags |XP_GRACEFUL_CLOSE“)

协议支持两阶段关闭操作，也称为“正常关闭操作”。如果不是，则协议仅支持中止关闭操作。

SupportsGuaranteedBandwidth

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32_API|Windows 套接字结构 |PROTOCOL_INFO|dwServiceFlags |XP_BANDWIDTH_ALLOCATION“)

协议具有建立和维护带宽的机制。

SupportsMulticasting

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32_API|Windows 套接字结构 |PROTOCOL_INFO|dwServiceFlags |XP_SUPPORTS_MULTICAST“)

协议支持多播。

SupportsQualityofService

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32_API|Windows 套接字结构 |WSAPROTOCOL_INFO|dwServiceFlags1 |XP1_QOS_SUPPORTED“)

协议能够得到底层分层服务提供商或传输运营商的服务质量 (QoS) 支持。 QoS 是组件集合，可对通过网络传输的数据子集进行区分和优先处理。 QoS 表示数据子集在遍历网络时获得更高的优先级或有保证的服务。

备注

Win32_NetworkProtocol 类派生自 CIM_LogicalElement。

示例

以下 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 类

语法

成员

属性

备注

示例

要求

另请参阅

反馈

其他资源