返回目录页面

更新配置:英特尔(R) PRO 网络适配器和 WMI 和 CDM Provider 用户指南

概述
更改适配器、组或 VLAN 设置
创建新(空)组
向组中添加适配器
从组中删除适配器
删除组
更改组模式
更改组中适配器的优先级
卸装适配器
创建 VLAN
更改 VLAN 属性
删除 VLAN
更新 Boot Agent


概述

在大多数情况下,要更新配置,客户端应用程序需要从 IANet_NetService 获取一个会话句柄,并将其存储在 IWbemContext 环境对象中。对配置的更改只有在对 IANet_NetService 调用了 Apply 方法之后才生效。对此要求有一些例外:

对某些操作,可使用环境中的 PreCheck 限定符来检查是否允许某项操作。这将允许用户界面在要求的情况下丢弃某些控制或菜单条目。

返回页首


更改适配器、组或 VLAN 设置

更改适配器、组或 VLAN:

要更改适配器、VLAN 或组设置,客户端必须先获取要更改的设置的对象路径。最好的方法是枚举对象上的设置,并存储该设置的 __PATH 属性(参见上文)。

客户端更新设置的最简单方法是:

  1. 从 WMI 获取设置对象的实例。
  2. 修改 CurrentValue 属性(使用 IWbemClassObject::Put())。
  3. 调用 IWbemServices::PutInstance() 将修改的实例传递回给 WMI Provider。PutInstance 必须以 WBEM_FLAG_UPDATE_ONLY 标志调用。

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,对要将 VLAN 添加到其上的适配器的 IANet_802dot1QVLANService 调用 CreateVLAN 方法。必须将下列参数传递到该方法:

此函数将在 Out 参数 VLANpath 中返回新创建的 VLAN 的对象路径。如果此项动作失败,检查 IANet_ExtendedStatus 以了解错误代码。

返回页首


更改 VLAN 的属性

更改 VLAN 的属性:

客户端能更改 VLAN 的 VLANNumber 和 VLANName 属性。要更改适配器的优先级,首先获取适配器的 IANet_VLAN 实例(例如,运用使用对象路径的 IWbemServices::GetObject )。

然后,将 VLANNumber 或 VLANName 更改到所需的值。最后,调用 IWbemClassObject::PutInstance 来指示 WMI Provider 更新属性,传递 WBEM_FLAG_UPDATE_ONLY 标志。如果此项动作失败,检查 IANet_ExtendedStatus 以了解错误代码。

返回页首


删除 VLAN

删除 VLAN:

要删除 VLAN,调用 IWbemServices::DeleteInstance,传递要删除的 VLAN 的对象路径。

返回页首


更新 Boot Agent

更新 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。


请阅读所有限制和免责声明。


返回目录页面 返回页首