CIM_NetworkAdapter 类
CIM_NetworkAdapter 类是一个抽象类,用于定义常规网络硬件概念 (例如永久地址或操作速度) 。 使用 CIM_DeviceSAPImplementation 关联传达信息。
网络适配器和相关终结点表示对等方之间连接的可能性。 连接的可能性与CIM_Controller的主、从和控制器或受控制关系明显不同。 但是,有时,单个设备同时充当网络适配器和控制器,例如,当光纤通道适配器作为计算机系统的 SCSI 控制器运行时。 在这种情况下,设备的各个方面面向网络,其他方面面向控制器。 应实例化控制器和适配器类,并且还应创建设备标识关系以链接设备的不同方面。
重要
DMTF (分布式管理任务组) CIM (Common Information Model) 类是生成 WMI 类的父类。 WMI 目前仅支持 CIM 2.x 版本架构。
以下语法从托管对象格式 (MOF) 代码简化而来,包括所有继承属性。 属性按字母顺序列出,而不是按 MOF 顺序列出。
语法
[Abstract, UUID("{8502C532-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class CIM_NetworkAdapter : CIM_LogicalDevice
{
boolean AutoSense;
uint16 Availability;
string Caption;
uint32 ConfigManagerErrorCode;
boolean ConfigManagerUserConfig;
string CreationClassName;
string Description;
string DeviceID;
boolean ErrorCleared;
string ErrorDescription;
datetime InstallDate;
uint32 LastErrorCode;
uint64 MaxSpeed;
string Name;
string NetworkAddresses[];
string PermanentAddress;
string PNPDeviceID;
uint16 PowerManagementCapabilities[];
boolean PowerManagementSupported;
uint64 Speed;
string Status;
uint16 StatusInfo;
string SystemCreationClassName;
string SystemName;
};
成员
CIM_NetworkAdapter 类具有以下类型的成员:
方法
CIM_NetworkAdapter 类具有这些方法。
方法 | 说明 |
---|---|
重 置 | 请求重置逻辑设备。 未由 WMI 实现。 |
SetPowerState | 定义逻辑设备的所需电源状态,以及设备何时应进入该状态。 未由 WMI 实现。 |
属性
CIM_NetworkAdapter 类具有这些属性。
-
AutoSense
-
-
数据类型: 布尔值
-
访问类型:只读
如果 为 TRUE,网络适配器可以自动确定附加网络媒体的速度或其他通信特征。
-
-
可用性
-
-
数据类型: uint16
-
访问类型:只读
-
限定符: MappingStrings (“MIF”。DMTF |操作状态|003.5“,”MIB。IETF |HOST-RESOURCES-MIB.hrDeviceStatus“)
设备的可用性和状态。
此属性继承自 CIM_LogicalDevice。
-
-
其他 (1)
-
未知 (2)
-
运行/全功率 (3)
-
警告 (4)
-
在测试 (5)
-
不适用 (6)
-
关机 (7)
-
下线 (8)
-
下班 (9)
-
降级 (10)
-
未安装 (11)
-
安装错误 (12)
-
节能 - 未知 (13)
-
已知设备处于节能模式,但其确切状态未知。
-
节能 - 低功耗模式 (14)
-
设备处于省电状态,但仍可正常运行,性能可能会下降。
-
节能 - 待机 (15)
-
设备无法正常工作,但可以快速通电。
-
Power Cycle (16)
-
节能 - 警告 (17)
-
设备处于警告状态,但也处于省电模式。
-
暂停 (18)
-
设备已暂停。
-
未就绪 (19)
-
设备未准备就绪。
-
未配置 (20)
-
设备未配置。
-
静止 (21)
-
设备安静。
Caption
-
数据类型: string
-
访问类型:只读
-
限定符: MaxLen (64) 、 DisplayName (“Caption”)
对象的简短文本说明。
此属性继承自 CIM_ManagedSystemElement。
ConfigManagerErrorCode
-
数据类型: uint32
-
访问类型:只读
-
限定符: 架构 (“Win32”)
Windows Configuration Manager错误代码。
此属性继承自 CIM_LogicalDevice。
此设备正常工作。 (0)
设备工作正常。
此设备未正确配置。 (1)
设备配置不正确。
Windows 无法为此设备加载驱动程序。 (2)
此设备的驱动程序可能已损坏,或者系统内存或其他资源不足。 (3)
此设备的驱动程序可能已损坏,或者系统内存或其他资源可能不足。
此设备无法正常工作。其中一个驱动程序或注册表可能已损坏。 (4)
设备无法正常工作。 其中一个驱动程序或注册表可能已损坏。
此设备的驱动程序需要 Windows 无法管理的资源。 (5)
设备的驱动程序需要 Windows 无法管理的资源。
此设备的启动配置与其他设备冲突。 (6)
设备的启动配置与其他设备冲突。
无法筛选。 (7)
缺少设备的驱动程序加载程序。 (8)
缺少设备的驱动程序加载程序。
此设备无法正常工作,因为控制固件错误地报告设备的资源。 (9)
设备无法正常工作;控制固件错误地报告了设备的资源。
此设备无法启动。 (10)
设备无法启动。
此设备失败。 (11)
设备失败。
此设备找不到可以使用的足够可用资源。 (12)
设备找不到足够的可用资源来使用。
Windows 无法验证此设备的资源。 (13)
Windows 无法验证设备的资源。
在重启计算机之前,此设备无法正常工作。 (14)
在重启计算机之前,设备无法正常工作。
此设备无法正常工作,因为可能存在重新枚举问题。 (15)
设备由于可能的重新枚举问题而无法正常工作。
Windows 无法识别此设备使用的所有资源。 (16)
Windows 无法识别设备使用的所有资源。
此设备请求未知资源类型。 (17)
设备正在请求未知资源类型。
重新安装此设备的驱动程序。 (18)
必须重新安装设备驱动程序。
使用 VxD 加载程序失败。 (19)
注册表可能已损坏。 (20)
注册表可能已损坏。
系统故障:尝试更改此设备的驱动程序。如果这不起作用,请参阅硬件文档。Windows 正在删除此设备。 (21)
系统故障。 如果更改设备驱动程序无效,请参阅硬件文档。 Windows 正在删除设备。
此设备已禁用。 (22)
设备已禁用。
系统故障:尝试更改此设备的驱动程序。如果这不起作用,请参阅硬件文档。 (23)
系统故障。 如果更改设备驱动程序无效,请参阅硬件文档。
此设备不存在、工作不正常或未安装其所有驱动程序。 (24)
设备不存在、工作不正常或未安装其所有驱动程序。
Windows 仍在设置此设备。 (25)
Windows 仍在设置设备。
Windows 仍在设置此设备。 (26)
Windows 仍在设置设备。
此设备没有有效的日志配置。 (27)
设备没有有效的日志配置。
未安装此设备的驱动程序。 (28)
未安装设备驱动程序。
此设备处于禁用状态,因为设备的固件未为其提供所需的资源。 (29)
设备已禁用;设备固件未提供所需的资源。
此设备使用另一个设备正在使用的中断请求 (IRQ) 资源。 (30)
设备正在使用另一个设备正在使用的 IRQ 资源。
此设备无法正常工作,因为 Windows 无法加载此设备所需的驱动程序。 (31)
设备无法正常工作;Windows 无法加载所需的设备驱动程序。
ConfigManagerUserConfig
-
数据类型: 布尔值
-
访问类型:只读
-
限定符: 架构 (“Win32”)
如果 为 TRUE,则设备使用的是用户定义的配置。
此属性继承自 CIM_LogicalDevice。
CreationClassName
-
数据类型: 字符串
-
访问类型:只读
-
限定符: CIM_Key
创建实例时使用的类或子类的名称。 与 类的其他键属性一起使用时,此属性允许唯一标识类及其子类的所有实例。
此属性继承自 CIM_LogicalDevice。
描述
-
数据类型: 字符串
-
访问类型:只读
-
限定符: DisplayName (“Description”)
对象的文本说明。
此属性继承自 CIM_ManagedSystemElement。
DeviceID
-
数据类型: 字符串
-
访问类型:只读
-
限定符: CIM_Key
用于唯一命名逻辑设备的地址或其他标识信息。
此属性继承自 CIM_LogicalDevice。
ErrorCleared
-
数据类型: 布尔值
-
访问类型:只读
如果 为 TRUE,则 现在清除 LastErrorCode 属性中报告的错误。
此属性继承自 CIM_LogicalDevice。
ErrorDescription
-
数据类型: 字符串
-
访问类型:只读
自由格式字符串,提供有关 LastErrorCode 属性中记录的错误和要执行的纠正操作的信息。
此属性继承自 CIM_LogicalDevice。
InstallDate
-
数据类型: datetime
-
访问类型:只读
-
限定符: MappingStrings (“MIF”。DMTF |ComponentID|001.5“) , DisplayName (”安装日期“)
对象的安装日期和时间。 此属性不需要值来指示已安装 对象。
此属性继承自 CIM_ManagedSystemElement。
LastErrorCode
-
数据类型: uint32
-
访问类型:只读
逻辑设备报告的最后一个错误代码。
此属性继承自 CIM_LogicalDevice。
MaxSpeed
-
数据类型: uint64
-
访问类型:只读
-
限定符: 单位 (“每秒位数”)
网络适配器的最大速度(以比特/秒 (BPS) 为单位)。
有关在脚本中使用 uint64 值的详细信息,请参阅 WMI 中的脚本。
名称
-
数据类型: string
-
访问类型:只读
-
限定符: DisplayName (“Name”)
对象的已知标签。 当子类化时,此属性可以重写为键属性。
此属性继承自 CIM_ManagedSystemElement。
NetworkAddresses
-
数据类型: 字符串 数组
-
访问类型:只读
-
限定符: MaxLen (64) , MappingStrings (“MIF。DMTF |网络适配器 802 端口|001.3“)
适配器的网络地址列表。
PermanentAddress
-
数据类型: string
-
访问类型:只读
-
限定符: MaxLen (64) , MappingStrings (“MIF。DMTF |网络适配器 802 端口|001.2“)
硬编码到适配器中的网络地址。 可以通过固件升级或软件配置更改硬编码地址。 如果已更改,则应在进行更改时更新字段。 如果网络适配器不存在任何硬编码地址,则此属性应留空。
PNPDeviceID
-
数据类型: string
-
访问类型:只读
-
限定符: 架构 (“Win32”)
Win32 即插即用逻辑设备的设备标识符。 此属性继承自 CIM_LogicalDevice。
示例:“*PNP030b”
PowerManagementCapabilities
-
数据类型: uint16 数组
-
访问类型:只读
逻辑设备与电源相关的特定功能的数组。
此属性继承自 CIM_LogicalDevice。
未知 (0)
不支持 (1)
已禁用 (2)
已启用 (3)
电源管理功能当前已启用,但确切的功能集未知或信息不可用。
自动输入的节能模式 (4)
设备可以根据使用情况或其他条件更改其电源状态。
电源状态可设置 (5)
支持 SetPowerState 方法。 此方法在父 CIM_LogicalDevice 类上找到,并且可以实现。 有关详细信息,请参阅 设计托管对象格式 (MOF) 类。
支持的电源循环 (6)
可以使用 PowerState 参数设置为 5 (Power Cycle) 调用 SetPowerState 方法。
支持定时开机 (7)
可以使用 PowerState 参数设置为 5 (Power Cycle) 和时间设置为开机的特定日期和时间或间隔来调用 SetPowerState 方法。
PowerManagementSupported
-
数据类型: 布尔值
-
访问类型:只读
如果 为 TRUE,则可以对设备进行电源管理,即进入省电状态。 如果 为 FALSE,则整数值 1 (“不支持”) 应为 PowerManagementCapabilities 数组中的唯一条目。
此属性不指示当前是否已启用电源管理功能,或者如果已启用,则支持哪些功能。 有关详细信息,请参阅 PowerManagementCapabilities 数组。 此属性继承自 CIM_LogicalDevice。
速度
-
数据类型: uint64
-
访问类型:只读
-
限定符: MappingStrings (“MIB”。IETF |RFC1213-MIB.ifSpeed“、”MIF.DMTF |网络适配器 802 端口|001.5“) , 单位 (”位/秒“)
估计当前带宽,以 BPS 为单位。 对于带宽变化的终结点或无法进行准确估计的终结点,此属性应包含标称带宽。
有关在脚本中使用 uint64 值的详细信息,请参阅 WMI 中的脚本。
Status
-
数据类型: string
-
访问类型:只读
-
限定符: MaxLen (10) 、 DisplayName (“Status”)
对象的当前状态。
此属性继承自 CIM_ManagedSystemElement。
包括以下值:
OK (“OK”)
错误 (“错误”)
已降级 (“已降级”)
未知 (“未知”)
Pred Fail (“Pred Fail”)
正在启动 (“正在启动”)
正在停止 (“停止”)
服务 (“Service”)
压力 (“有压力”)
NonRecover (“NonRecover”)
无联系人 (“无联系人”)
Lost Comm (“Lost Comm”)
StatusInfo
-
数据类型: uint16
-
访问类型:只读
-
限定符: MappingStrings (“MIF”。DMTF |操作状态|003.3“)
逻辑设备的状态。 如果此属性不适用于逻辑设备,则应使用值 5 (不适用) 。
此属性继承自 CIM_LogicalDevice。
其他 (1)
未知 (2)
已启用 (3)
已禁用 (4)
不适用 (5)
SystemCreationClassName
-
数据类型: string
-
访问类型:只读
-
限定符: 传播 (“CIM_System。CreationClassName“) , CIM_Key
确定系统的创建类名称的范围。
此属性继承自 CIM_LogicalDevice。
SystemName
-
数据类型: 字符串
-
访问类型:只读
-
限定符: 传播 (“CIM_System。Name“) , CIM_Key
确定系统名称的范围。
此属性继承自 CIM_LogicalDevice。
备注
CIM_NetworkAdapter 类派生自 CIM_LogicalDevice。
WMI 不实现此类。 有关派生自 CIM_NetworkAdapter 的类,请参阅 Win32 类。
本文档派生自 DMTF 发布的 CIM 类说明。 Microsoft 可能已对更正小错误、符合 Microsoft SDK 文档标准或提供详细信息进行了更改。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows Vista |
最低受支持的服务器 |
Windows Server 2008 |
命名空间 |
Root\CIMV2 |
MOF |
|
DLL |
|