CFrameworkQuery class (frquery.h)
[The CFrameworkQuery class is part of the WMI Provider Framework and is now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.]
The CFrameworkQuery class is used to parse and manipulate a query. It contains methods that return specific property values and methods that test the query to determine the particular properties that are included.
Provider writers will generally not need to create any derived classes from this class, or to create any instances of this class. More commonly, you will be passed an instance of this class and will use the various methods to determine what information is being requested by the client.
CFrameworkQuery has these types of members:
| Method | Description |
|---|---|
| AllPropertiesAreRequired | Indicates whether all of the properties for the instance are being requested. |
| GetQuery | Retrieves the actual WQL command associated with the CFrameworkQuery object. |
| GetQueryClassName | Retrieves the class name from the query. |
| GetRequiredProperties | Returns a list of all of the properties required to satisfy a query. It includes the properties from both the SELECT and WHERE clauses. |
| GetValuesForProp | Returns all of the values for a particular property that are generated by that property as it appears within the query. |
| IsPropertyRequired | Determines if a particular property was requested by the query. Both the SELECT and WHERE clauses are checked. |
| KeysOnly | Indicates whether only the key properties are required. |
Methods
The CFrameworkQuery class has these methods.
| CFrameworkQuery::AllPropertiesAreRequired The AllPropertiesAreRequired method indicates whether all of the properties for the instance are requested. |
| CFrameworkQuery::GetQuery The GetQuery method retrieves the actual WQL command associated with the CFrameworkQuery object. |
| CFrameworkQuery::GetQueryClassName The GetQueryClassName method retrieves the class name from the query. |
| CFrameworkQuery::GetRequiredProperties The GetRequiredProperties method returns a list of all of the properties specified in the SELECT statement of a query. It returns the properties from both the SELECT and WHERE clauses. |
| CFrameworkQuery::GetValuesForProp The GetValuesForProp method returns all of the values for a particular property that are generated by that property as it appears within the query. (overload 1/2) |
| CFrameworkQuery::GetValuesForProp The GetValuesForProp method returns all of the values for a particular property that are generated by that property as it appears within the query. (overload 2/2) |
| CFrameworkQuery::IsPropertyRequired The IsPropertyRequired method determines if a particular property was requested by the query. Both the SELECT and WHERE clauses are checked. |
| CFrameworkQuery::KeysOnly The KeysOnly method indicates whether only the key properties are required. |
Remarks
The destructor for this class is CFrameworkQuery::~CFrameworkQuery.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Minimum supported server | Windows Server 2008 |
| Target Platform | Windows |
| Header | frquery.h (include FwCommon.h) |