Utils.FindMVEntries Method

The FindMVEntries (String, Int64, Int32) method is a static method that retrieves the metaverse entries with the specified Int64 attribute value and maximum number of results.

Syntax

public MVEntry[] FindMVEntries(
  String attributeName,
  Int64 value,
  Int32 maxResults
);
Public Function FindMVEntries( _
  ByVal attributeName As String, _
  ByVal value As Int64, _
  ByVal maxResults As Int32 _
) As MVEntry[]

Parameters

  • attributeName
    Contains the name of the metaverse attribute to retrieve.

  • value
    Contains an Int64 value that the attribute identified by attributeName must contain.

  • maxResults
    Contains the maximum number of metaverse entries to retrieve.

Return Value

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:

For more information about the stopped-extension-dll-exception, see Return Strings.

Requirements

Product ILM 2007 FP1
Namespace Microsoft.MetadirectoryServices
Assembly Microsoft.MetadirectoryServices
.NET Framework .NET Framework 2.0

See Also

MVEntry
Return Strings
Utils

Send comments about this topic to Microsoft

Build date: 2/16/2009