CFrameworkQuery::GetValuesForProp method

[The CFrameworkQuery class is part of the WMI Provider Framework which 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 GetValuesForProp method returns all of the values for a particular property that are generated by that property as it appears within the query.

For example, a call to GetValuesForProp(L"Name", sa) returns the array sa, which contains all the values of "Name" that require instances to be sent back to satisfy the query. If sa contains {"a","b"}, then all the instances where "Name=a" plus all the instances where "Name=b" must be sent back to completely satisfy the query.

If the constraints on "Name" are not sufficiently limiting, an empty sa array is returned.

Syntax

HRESULT GetValuesForProp(
  LPCWSTR         wszPropName,
  CHStringArray & achNames
);

Parameters

wszPropName

Array of values for the property specified by wszPropName.

achNames

Name of the target property.

Return value

This method returns WBEM_S_NO_ERROR on success, and WBEM_E_FAILED, or any other HRESULT error code, on failure.

Remarks

Given a property name, this method returns all of the result values in a CHStringArray or vector container. The vector container holds _bstr_t objects that contain the result values.

For example, the following list lists the values that are returned by GetValuesForProp for a variety of queries when called with wszPropName set to "Drive".

Query Return value Result

SELECT * FROMWin32_Directory

WHERE Drive = "C:"

WBEM_S_NO_ERROR C:

SELECT * FROMWin32_Directory

WHERE Drive = "C:" OR FileSize = 256

WBEM_S_NO_ERROR No results; aszNames is empty.

SELECT * FROMWin32_Directory

WHERE Drive = "C:" OR Drive = "D:"

WBEM_S_NO_ERROR C:, D:

SELECT * FROMWin32_Directory

WHERE Drive <> "C:"

WBEM_S_NO_ERROR No results; aszNames is empty.

SELECT * FROMWin32_Directory

WHERE Path = "\DOS"

WBEM_S_NO_ERROR No results; aszNames is empty.
 

The GetValuesForProp method only supports string types. For example, the following query, followed by a call to GetValuesForProp("PropInt", values), returns WBEM_E_INVALID_QUERY while GetValuesForProp("PropStr", values) returns S_OK.

SELECT * FROM Test WHERE PropInt = 32 AND PropStr = "a"

Requirements

   
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header frquery.h (include FwCommon.h)
Library FrameDyn.lib
DLL FrameDynOS.dll; FrameDyn.dll

See also

CFrameworkQuery

Provider::ExecQuery