Edit

CFrameworkQuery class (frquery.h)

  • Article

[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)