Updating the configuration, Overview, Changing the adapter, team, or vlan settings – Dell Intel PRO Family of Adapters User Manual
Page 45
Updating the Configuration: Intel® PRO Network Adapters WMI
and CDM Providers User Guide
Changing the Adapter, Team, or VLAN Settings
Removing an Adapter from a Team
Changing an Adapter's Priority within a Team
Changing the Attributes of a VLAN
Overview
In most cases, to update the configuration, the client application will need to get a session handle from the IANet_NetService
class and store this handle in an IWbemContext context object. Changes to the configuration will only occur when the Apply
method on the IANet_NetService is called. There are some exceptions to this requirement:
Changes to the boot agent class will occur immediately as they are made and do not require a session handle.
Certain method calls (e.g. identify adapter) cause an operation to be carried out before Apply is called.
For some operations you can use the PreCheck qualifier in the context to check to see if an operation is allowed. This is to
allow a user interface to disable certain controls or menu items if required.
Changing the Adapter, Team, or VLAN Settings
Changing the adapter, team or VLAN:
Requires Session Handle.
PreCheck is available.
Requires an Apply call before operation is executed.
To change an adapter, VLAN or Team setting, the client must first get the object path of the setting that it will change. This is
best done by enumerating the settings on the object and storing the __PATH attribute of the setting (see above).
The easiest way for the client to update a setting is to:
1. Get an instance of the setting object from the WMI.
2. Modify the CurrentValue attribute (using IWbemClassObject::Put()).
3. Call IWbemServices::PutInstance() to pass the modified instance back to the WMI Provider. PutInstance must be
called with the flag WBEM_FLAG_UPDATE_ONLY.
The WMI Provider will validate the CurrentValue and return WBEM_E_FAIL if the validation failed. The exact reason for the
failure will be returned in the Description attribute of the IANet_ExtendedStatus object.
Setting specific descriptions include:
The integer setting value was less than the minimum allowed.
The integer setting value was greater than the maximum allowed.
The integer setting value is not one of the allowable steps.
The length of the string setting is bigger than the maximum allowed.
The setting value is not one of the allowable values.
45