IFPCRuleElements4::FindMatchedElements method

Applies to: desktop apps only

The FindMatchedElements method finds rule elements that match the specified criteria.

Syntax

HRESULT FindMatchedElements(
  [in]   BSTR searchCriteria,
  [in]   String searchCriteria,
  [out]  BSTR *pMatchedElements
);

FPCRuleElements.FindMatchedElements( _
  ByVal searchCriteria As BSTR, _
  ByVal searchCriteria As String, _
  ByRef pMatchedElements As BSTR _
) As String

Parameters

• searchCriteria [in]

  C++	Required. BSTR that specifies the search criteria. This string contains either literal text that must be found, or a list of criteria in the form of property-value pairs separated by white space, each given as "<property>:<value>". The search criteria are fulfilled only when all the elements are statisfied.
  VB	Required. String that specifies the search criteria. This string contains either literal text that must be found, or a list of criteria in the form of property-value pairs separated by white space, each given as "<property>:<value>". The search criteria are fulfilled only when all the elements are statisfied.

• pMatchedElements [out]
  Pointer to a BSTR that is set on return to a string value containing a textual representation of the matched elements. If no matches are found, this parameter contains an empty string on return.

Return value

C++

This method returns S_OK if the call is successful; otherwise, it returns an error code.

VB

This method returns a string value containing a textual representation of the matched elements if successful. Otherwise, an error is raised that can be intercepted by using an error handler. If no matches are found, an empty string is returned.

Requirements

See also

FPCRuleElements

Build date: 7/12/2010