Utils.FindMVEntries Method

Article
02/16/2009

The FindMVEntries (String, Byte[]) method is a static method that retrieves the metaverse entries with the specified byte array attribute value.

Syntax

public MVEntry[] FindMVEntries(
  String attributeName,
  Byte[] value
);

Public Function FindMVEntries( _
  ByVal attributeName As String, _
  ByVal value() As Byte _
) As MVEntry[]

Parameters

attributeName
Contains the name of the metaverse attribute to retrieve.
value
Contains an array of bytes that the attribute identified by attributeName must contain.

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.
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 and throw the stopped-extension-dll-exception if called from the following methods:

The rules extension object constructor
The IMASynchronization.Initialize method
The IMASynchronization.Terminate method
The IMVSynchronization.Initialize method
The IMVSynchronization.Terminate method

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

Requirements

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