Getting the Current Configuration

The client does not need to get a client handle to read the current configuration.  Clients can use a NULL context, however, any error messages will be returned in the default language for the managed machine.

In the following table, items enclosed in {  } are object paths.  These paths are assumed to have been obtained from  previous WQL queries.  The client should never need to construct an object path without doing a query.  The __PATH attribute of every object contains the object path for that object.

In all the following use cases, the methods IWbemServices::ExecQuery or IWbemServices::ExecQueryAsync  are used to execute WQL queries.

Getting the Physical Adapters

The main class for the adapters is IANet_EthernetAdapter.  This class is used for both physical and virtual adapters, and the client needs to know how to distinguish between them.

Task WQL Query Result Class Comment
Enumerate all adapters SELECT * FROM IANet_EthernetAdapter IANet_EthernetAdapter Returns all IANet_EthernetAdapters.  This is equivalent to IWbemServices::CreateInstanceEnumAsync
Determine if adapter is virtual ASSOCIATORS OF {adapter path}

     WHERE AssocClass = IANet_NetworkVirtualAdapter

 

IANet_TeamOfAdapters If the query results in no classes then the adapter is a real adapter.

Getting the Team Configuration

The main classes in the teaming schema are IANet_LogicalEthernetAdapter, IANet_TeamOfAdapters, IANet_NetworkVirtualAdapter and IANet_TeamedMemberAdapter.  

The association class IANet_NetworkVirtualAdapter contains no useful data – clients are really only interested in the endpoints of this association.  IANet_TeamedMemberAdapter does contain useful data about how the member adapter is used within the team.

Task WQL Queries Result Class Comments
Enumerate all teams SELECT * FROM IANet_TeamOfAdapters IANet_TeamOfAdapters There is one instance of IANet_TeamOfAdapters for each team. This is equivalent to IWbemServices::CreateInstanceEnumAsync.
Get the virtual adapter for a team ASSOCIATORS OF {IANet_TeamOfAdapters path} WHERE AssocClass = IANet_NetworkVirtualAdapter IANet_LogicalEthernetAdapter Returns only the adapter object for the virtual adapter in the team.  This adapter will not exist if the team has been created but Apply has not been called.  (see below on updating the configuration).
Enumerate the team’s member adapters ASSOCIATORS OF {IANet_TeamOfAdapters path} WHERE AssocClass = IANet_TeamedMemberAdapter IANet_PhysicalEthernetAdapter Returns the adapters which are in the team, but does not describe what role the adapter plays.
Determine an adapter’s role in a team REFERENCES OF {IANet_PhysicalEthernetAdapter path} WHERE ResultClass = IANet_TeamedMemberAdapter IANet_TeamedMemberAdapter The class contains information about how the member adapter relates to the team and its current status within the team.

Getting the VLAN Configuration

Each adapter that supports VLANs has an IANet_802dot1QVLANService associated with it, using the association class IANet_Device802do1QVVLANServiceImplementation.  If an adapter does not have an instance of this class associated with it, then it does not support VLANs.

Each VLAN is represented by an instance of  IANet_VLAN.  The VLAN is not directly associated with the adapter – it is associated with the IANet_802dot1QVLANService for the adapter.

The association class IANet_VLANFor is used to associate each VLAN instance with the correct IANet_802dot1QVLANService.  This class contains no useful data for the user.

Task WQL Queries Result Class Comments
Get the 802.1q VLAN service object associated with an adapter ASSOCIATORS OF {IANet_EthernetAdapter path} WHERE ResultClass = IANet_802dot1QVLANService IANet_802dot1QVLANService Returns one or no object(s).
Get the VLANs on an adapter ASSOCIATORS OF {IANet_802dot1QVLANService path} WHERE ResultClass = IANet_VLAN IANet_VLAN This can return no objects if there are no VLANs installed.

Getting the Boot Agent Information

Each adapter that can support a boot agent in flash ROM will have an IANet_BootAgent instance associated with it using the IANet_DeviceBootServiceImplementation association class.

Task WQL Queries Result Class Comments
Get the Boot Agent associated with an adapter ASSOCIATORS OF {path of IANet_EthernetAdapter} WHERE ResultClass = IANet_BootAgent IANet_BootAgent The following read only attributes provide information on the boot ROM image for this adapter:

InvalidImageSignature, Version, UpdateAvailable, FlashImageType

 

Home


Copyright© 2004 Intel Corporation. Legal Information