概述
更改适配器、组或 VLAN 设置
创建新(空)组
向组中添加适配器
从组中删除适配器
删除组
更改组模式
更改组中适配器的优先级
卸装适配器
创建 VLAN
更改 VLAN 属性
删除 VLAN
更新 Boot Agent
在大多数情况下,要更新配置,客户端应用程序需要从 IANet_NetService 获取一个会话句柄,并将其存储在 IWbemContext 环境对象中。对配置的更改只有在对 IANet_NetService 调用了 Apply 方法之后才生效。对此要求有一些例外:
对某些操作,可使用环境中的 PreCheck 限定符来检查是否允许某项操作。这将允许用户界面在要求的情况下丢弃某些控制或菜单条目。
更改适配器、组或 VLAN:
要更改适配器、VLAN 或组设置,客户端必须先获取要更改的设置的对象路径。最好的方法是枚举对象上的设置,并存储该设置的 __PATH 属性(参见上文)。
客户端更新设置的最简单方法是:
WMI Provider 将验证 CurrentValue;如果验证失败,则返回 WBEM_E_FAIL。失败的确切原因将在 IANet_ExtendedStatus 对象的 Description 属性中返回。
针对设置的描述包括:
在 IANet_SettingEnum、IANet_SettingSlider 或 IANet_SettingMultiSelection 的当前值不是允许的值之一的情况下,返回最后一个描述。
客户端能更改的唯一设置属性是 CurrentValue。WMI Provider 将忽略对任何其他值的更改。
此设置类没有受支持的方法。要更改一个设置,修改 CurrentValue 属性,调用 PutInstance。
若要创建新组,创建一个 IANet_TeamOfAdapters 实例(即:使用 IWbemServices::GetObject() 以获取 IANet_TeamOfAdapters 的类对象,然后使用 IWbemServices::SpawnInstance() 来创建此对象的实例)。
然后,使用 IWbemClassObject::Put 将实例中的 TeamMode 属性设置为想要的组类型(例如:AFT)。最后,调用 IWbemServices::PutInstance() 来创建组,传递 WBEM_FLAG_CREATE_ONLY 标志。
新组的对象路径存储在调用完成之后被传递回来的 IWbemCallResultObject 中。IWbemCallResult::GetResultString 方法将获取一个新的对象路径。
如果此动作失败,客户端将检查 IANet_ExtendedStatus 以了解失败的原因。
组的虚拟 IANet_EthernetAdapter 和 IANet_IPProtocolEndpoint 类在调用 Apply 之后将不再可用。可使用与新 IANet_TeamOfAdapters 关联的 IANet_Configuration 对象获取组的设置。
向组中添加适配器:
要向组中添加适配器,创建一个 IANet_TeamedMemberAdapter 实例(即:使用 IWbemServices::GetObject() 获取 IANet_TeamedMemberAdapter 的类对象,然后使用 IWbemServices::SpawnInstance() 来创建此对象的实例)。
对象中的以下属性必须使用 IWbemClassObject::Put(): 来设置:
还可以设置组中适配器的优先级别。最后,调用 IWbemServices::PutInstance() 将适配器添加到组,传递 WBEM_FLAG_CREATE_ONLY 标志。如果此项动作失败,检查 IANet_ExtendedStatus 以了解错误代码。
从组中删除适配器:
要从组中删除适配器,使用 IWbemServices::DeleteInstance() 删除将适配器与组关联的 IANet_TeamedMemberAdapter 实例。如果此项动作失败,检查 IANet_ExtendedStatus 以了解错误代码。
删除组:
要删除组,使用 IWbemServices::DeleteInstance() 删除 IANet_TeamOfAdapters 实例。如果此项动作失败,检查 IANet_ExtendedStatus 以了解错误代码。
更改组模式:
要更改组模式,获取该组的 IANet_TeamOfAdapters 实例(例如:运用使用该组对象路径的 IWbemServices::GetObject)。然后,使用 IWbemClassObject::Put 来更改该组的 TeamMode 属性。最后,调用 IWbemClassObject::PutInstance 来指示 WMI Provider 更新组模式,传递 WBEM_FLAG_UPDATE_ONLY 标志。如果此项动作失败,检查 IANet_ExtendedStatus 以了解错误代码。
更改组中适配器的优先级:
要更改适配器优先级,客户机应该首先获取适配器的 IANet_TeamedMemberAdapter 实例。(例如:运用使用对象路径的 IWbemServices::GetObject )。然后,客户端可使用 IWbemClassObject::Put 来更改适配器的 AdapterFunction 属性。最后,客户端需要调用 IWbemClassObject::PutInstance 指示 WMI Provider 更新适配器优先级。如果此项动作失败,客户端应该检查 IANet_ExtendedStatus 以了解错误代码。
卸装适配器:
若要卸装适配器,调用 IWbemServices::DeleteInstance,传递要卸装的适配器的对象路径。
创建 VLAN:
要创建 VLAN,对要将 VLAN 添加到其上的适配器的 IANet_802dot1QVLANService 调用 CreateVLAN 方法。必须将下列参数传递到该方法:
此函数将在 Out 参数 VLANpath 中返回新创建的 VLAN 的对象路径。如果此项动作失败,检查 IANet_ExtendedStatus 以了解错误代码。
更改 VLAN 的属性:
客户端能更改 VLAN 的 VLANNumber 和 VLANName 属性。要更改适配器的优先级,首先获取适配器的 IANet_VLAN 实例(例如,运用使用对象路径的 IWbemServices::GetObject )。
然后,将 VLANNumber 或 VLANName 更改到所需的值。最后,调用 IWbemClassObject::PutInstance 来指示 WMI Provider 更新属性,传递 WBEM_FLAG_UPDATE_ONLY 标志。如果此项动作失败,检查 IANet_ExtendedStatus 以了解错误代码。
删除 VLAN:
要删除 VLAN,调用 IWbemServices::DeleteInstance,传递要删除的 VLAN 的对象路径。
更新 Boot Agent:
客户端能使用方法调用来更新 Boot Agent 映像。要读取/写入快闪映像,首先获取适配器的 IANet_BootAgent 实例(例如,运用使用对象路径的 IWbemServices::GetObject)。
然后,执行 ReadFlash() 来读取现有快闪引导 ROM 映像或者 ProgramFlash() 来更新快闪引导 ROM 映像。如果此项动作失败,检查 IANet_ExtendedStatus 以了解错误代码。
| 任务 | WMI 方法 | 结果 | 说明 |
| 更新或插入适配器的引导 ROM 映像。 | uint32 ProgramFlash( [IN, ValueMap {"0","1"} , Values {"Check Version", "Write Flash"}:Amended uint32 Action, [IN] uint8 NewFlashData[], [OUT] string strErrorMessage ); |
如果指定了“检查版本”动作,要是 NewFlashData[] 中正被更新的引导 ROM 映像比 NIC 中的引导 ROM 映像时间更早,此方法将返回一个警告消息。 如果指定“写入”动作,这将以 NewFlashData[] 更新 NIC 上的 FLASH ROM。 |
此方法用于更新 NIC 上的快闪 ROM。这将使 NIC 在更新快闪的时候停止与网络的通讯。 |
| 读取引导 ROM 映像 | uint32 ReadFlash( [OUT] uint8 FlashData[] ); |
FlashData[] 包含 NIC 上的快闪 ROM 映像。 | 此方法读取 NIC 上可被保存入文件的快闪 ROM。 |
请阅读所有限制和免责声明。