Microsoft Identity Integration Server 2003 Developer Reference

Utils.FindMVEntries (String, Value, Int32)

The FindMVEntries (String, Value, Int32) method is a static method that retrieves the metaverse entries with the specified attribute value and maximum number of results.
[C#]
public MVEntry[] FindMVEntries(
  String attributeName,
  Value value,
  Int32 maxResults
);
[Visual Basic .NET]
Public Function FindMVEntries( _
  ByVal attributeName As String, _
  ByVal value As Value, _
  ByVal maxResults As Int32 _
) As MVEntry[]

Parameters

attributeName
Contains the name of the metaverse attribute to retrieve.
value
Contains a Value object the contains the value that the attribute identified by attributeName must contain.
maxResults
Contains the maximum number of metaverse entries to retrieve.

Return Values

Returns an array of MVEntry objects that represent the metaverse entries found in the search.

Exceptions

Exception type Condition
ArgumentNullException The attributeName or value parameter is null.
ArgumentOutOfRangeException The maxResults parameter is less than or equal to zero.
InvalidOperationException The value represented by the value parameter cannot be converted to the data type of the attribute identified by attributeName.

Remarks

This method will throw an InvalidOperationException exception and the management agent run profile will stop with a status of stopped-extension-dll-exception if called from the following methods:

Requirements

Product: Microsoft Identity Integration Server 2003
Namespace: Defined in Microsoft.MetadirectoryServices.
Assembly: Requires Microsoft.MetadirectoryServices (in Microsoft.MetadirectoryServices.dll).
.NET Framework: Requires .NET Framework 1.1.

See Also

MVEntry, Utils