IWbemQuery::GetAnalysis method (wmiutils.h)

Article
02/22/2024

The IWbemQuery::GetAnalysis method gets the results of a successful query parse.

Syntax

HRESULT GetAnalysis(
  [in]  ULONG  uAnalysisType,
  [in]  ULONG  uFlags,
  [out] LPVOID *pAnalysis
);

Parameters

[in] uAnalysisType

Type of analysis to get.

WMIQ_ANALYSIS_RPN_SEQUENCE (1)

Used if the query has a SELECT clause. When this type of analysis is used, pAnalysis points to an SWbemRpnEncodedQuery structure.

WMIQ_ANALYSIS_ASSOC_QUERY (2)

Used to return information about association type queries. When this type of analysis is used, pAnalysis points to an SWbemAssocQueryInf structure.

WMIQ_ANALYSIS_PROP_ANALYSIS_MATRIX (3)

Unused. Reserved for future use.

WMIQ_ANALYSIS_QUERY_TEXT (4)

Used to return a text string that has the original query text. If this type of analysis is used, pAnalysis points to a text string that contains the original query text.

You can use this parameter if a parser object is passed to another method.

[in] uFlags

Reserved for future use.

[out] pAnalysis

Pointer to the analysis generated by a call to IWbemQuery::GetAnalysis. It is important to free up this memory by calling IWbemQuery::FreeMemory.

Return value

This method returns an HRESULT that indicates the status of a method call.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Target Platform	Windows
Header	wmiutils.h
Library	Wbemuuid.lib
DLL	Wmiutils.dll