Win32_NetworkProtocol 类
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 |
|
| DLL |
|
另请参阅
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈