IConditionFactory2::ResolveCondition method (structuredquery.h)

Article
02/22/2024

Performs a variety of transformations on a condition tree, and thereby the resolved condition for evaluation. The returned object supports ICondition and ICondition2.

Syntax

HRESULT ResolveCondition(
  [in]           ICondition                      *pc,
  [in]           STRUCTURED_QUERY_RESOLVE_OPTION sqro,
  [in, optional] const SYSTEMTIME                *pstReferenceTime,
  [in]           REFIID                          riid,
  [out]          void                            **ppv
);

Parameters

[in] pc

Type: ICondition*

Pointer to an ICondition object to be resolved.

[in] sqro

Type: STRUCTURED_QUERY_RESOLVE_OPTION

Specifies zero or more of the STRUCTURED_QUERY_RESOLVE_OPTION flags. The SQRO_NULL_VALUE_TYPE_FOR_PLAIN_VALUES flag is automatically added to sqro.

[in, optional] pstReferenceTime

Type: SYSTEMTIME const*

Pointer to a SYSTEMTIME value to use as the reference date and time. A null pointer can be passed if sqro is set to the SQRO_DONT_RESOLVE_DATETIME flag.

[in] riid

Type: REFIID

The desired IID of the enumerating interface: either IEnumUnknown, IEnumVARIANT, or (for a negation condition) IID_ICondition.

[out] ppv

Type: void**

Receives a pointer to zero or more ICondition and ICondition2 objects.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The StructuredQuerySample demonstrates how to read lines from the console, parse them using the system schema, and display the resulting condition trees.

Refer to the Resolve method for additional detail.

Requirements

Requirement	Value
Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	Windows Server 2008 R2 [desktop apps only]
Target Platform	Windows
Header	structuredquery.h