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.
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. |
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. |
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. |
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
|
Copyright© 2004 Intel Corporation. Legal Information