ICondition::GetSubConditions Method

  • Article

Retrieves a collection of the subconditions of the search condition node and the IID of the interface for enumerating the collection.

Syntax

HRESULT GetSubConditions(      
    REFIID riid,
    void **ppv
);

Parameters

  • riid
    [in]  The desired IID of the enumerating interface: either IID_IEnumUnknown, IID_IEnumVARIANT or (for a negation condition) IID_ICondition.
  • ppv
    [out, retval]  Receives a collection of zero or more ICondition objects. Each object is a subcondition of this condition node. If riid was IID_ICondition and this is a negation condition, this parameter receives the single subcondition.

Return Value

Returns S_OK if successful, E_FAIL if this is a leaf node, or an error value otherwise.

Remarks

The riid parameter must be the GUID of an IEnumUnknown or IEnumVARIANT interface or in the case of a negation node, IID_ICondition.

If the subcondition is a negation node, ppv is set to an enumeration of one element.

If the node is a conjunction or disjunction node, ppv is set to an enumeration of the subconditions.

See Also

ICondition, CONDITION_TYPE, CONDITION_OPERATION, ICondition2