The FindMVEntries method is a static method that retrieves the metaverse entries with the specified string attribute value and maximum number of results. The results are returned in the specified collation order.
Namespace: Microsoft.MetadirectoryServices
Assembly: Microsoft.MetadirectoryServicesEx (in microsoft.metadirectoryservicesex.dll)

Usage

Visual Basic 
Dim attributeName As String
Dim value As String
Dim maxResults As Integer
Dim collationOrder As String
Dim returnValue As MVEntry()

returnValue = Utils.FindMVEntries(attributeName, value, maxResults, collationOrder)

Syntax

Visual Basic 
Public Shared Function FindMVEntries ( _
		attributeName As String, _
		value As String, _
		maxResults As Integer, _
		collationOrder As String _
) As MVEntry()
C# 
public static MVEntry[] FindMVEntries (
		string attributeName,
		string value,
		int maxResults,
		string collationOrder
)
C++ 
public:
static array<MVEntry^>^ FindMVEntries (
		String^ attributeName, 
		String^ value, 
		int maxResults, 
		String^ collationOrder
)
J# 
public static MVEntry[] FindMVEntries (
		String attributeName, 
		String value, 
		int maxResults, 
		String collationOrder
)
JScript 
public static function FindMVEntries (
		attributeName : String, 
		value : String, 
		maxResults : int, 
		collationOrder : String
) : MVEntry[]

Parameters

attributeName

Contains the name of the metaverse attribute to retrieve.

value

Contains a string that the attribute identified by attributeName must contain.

maxResults

Contains the maximum number of metaverse entries to retrieve.

collationOrder

Contains a string that specifies the collation order. This string takes the form of the collation strings provided by the fn_helpcollations SQL function.

Return Value

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

Exceptions

Exception type Condition
System.ArgumentNullException

The attributeName or value parameter is null.
System.ArgumentOutOfRangeException

The maxResults parameter is less than or equal to zero.
System.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 System.InvalidOperationException exception and the management agent run profile will stop with a status of stopped-extension-dll-exception if called from the following methods:


Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Target Platforms

See Also