Optimized wql queries, Overview, Getting one setting – Dell Intel PRO Family of Adapters User Manual

Page 52

Optimized WQL Queries: Intel® PRO Network Adapters WMI and

CDM Providers User Guide

Overview

Overview

The WMI Provider is optimized to allow applications to get settings using queries. The WMI Provider can recognize the

following queries and will only return the objects that match. All other queries will result in the WMI Provider getting all the

settings on all objects and CIMOM will filter them before they reach the application. With several adapters, teams, and VLANs,

this can cause a delay of several seconds when retrieving required data.

Getting the Settings for a Particular Adapter, VLAN, or Team

The following query will get only the settings for a particular adapter, VLAN or team. WQL does not allow any additional

clauses in the WHERE clause.

ASSOCIATORS OF {IANet_Configuration path} WHERE AssocClass = IANet_SettingContext

Getting One Setting

The following query can be used to get a single setting for an object without querying to get them all:

SELECT * FROM [SETTING CLASS] WHERE ParentId="[Device ID]" AND ParentType="[type]" AND

Caption="[SETTING NAME]"

Notes:

The class must be the exact setting class, not a base class (e.g. IANet_SettingInt).

Acceptable ParentTypes are "NIC", "Team" , "VLAN" or "BootAgent".

ParentId is the GUID that uniquely defines the object with the setting (for an adapter, this is the DeviceId).

This is not a recommended method of getting the settings associated for an object; the preferred method is use

associations. However, WQL does not support the complex query required (i.e., WQL does not support ASSOCIATORS

OF {IANet_Configuration path} WHERE AssocClass = IANet_SettingContext AND Caption="[SETTING NAME]")

Please read all