IRelationshipClass.GetObjectsMatchingObjectSet Method

Gets rows pairs of objects that are related to the specified origin or destination object set.

[Visual Basic .NET]
Public Function GetObjectsMatchingObjectSet ( _
    ByVal srcObjectSet As ISet _
) As IRelClassEnumRowPairs

[C#]
public IRelClassEnumRowPairs GetObjectsMatchingObjectSet (
    ISet srcObjectSet
);

[C++]
HRESULT GetObjectsMatchingObjectSet(
  ISet* srcObjectSet,
  IRelClassEnumRowPairs** matchedPairRows
);

[C++]

Parameters
srcObjectSet [in]

  srcObjectSet is a parameter of type ISet
matchedPairRows [out, retval]

  matchedPairRows is a parameter of type IRelClassEnumRowPairs

Product Availability

Remarks

The GetObjectsMatchingObjectSet method returns an enumerator of related object pairs based on the object set provided as a parameter. The enumerator contains a related object pair for each relationship participated in by the input objects. For example, in a relationship class with 1:1 cardinality, passing three objects into this method will return three related object pairs, assuming all three objects participate in a relationship. In a relationship class with 1:M or M:N cardinality, passing in a single object could conceivably result in an enumerator with multiple related object pairs, if the object participates in several relationships.

If the input set is constructed with a cursor, ensure that a non-recycling cursor is used.

See Also