नोट
इस पेज तक पहुँच के लिए प्रमाणन की आवश्यकता होती है. आप साइन इन करने या निर्देशिकाओं को बदलने का प्रयास कर सकते हैं.
इस पेज तक पहुँच के लिए प्रमाणन की आवश्यकता होती है. आप निर्देशिकाओं को बदलने का प्रयास कर सकते हैं.
[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 |
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
| Requirement | Value |
|---|---|
| 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 |