Utils.FindMVEntries Method (String, Byte[])

The FindMVEntries method is a static method that retrieves the metaverse entries with the specified byte array attribute value.

Namespace: Microsoft.MetadirectoryServices
Assembly: Microsoft.MetadirectoryServicesEx (in Microsoft.MetadirectoryServicesEx.dll)

Usage

'Usage
Dim attributeName As String
Dim value As Byte()
Dim returnValue As MVEntry()

returnValue = Utils.FindMVEntries(attributeName, value)

Syntax

'Declaration
Public Shared Function FindMVEntries ( _
    attributeName As String, _
    value As Byte() _
) As MVEntry()

public static MVEntry[] FindMVEntries (
    string attributeName,
    byte[] value
)

public:
static array<MVEntry^>^ FindMVEntries (
    String^ attributeName, 
    array<unsigned char>^ value
)

public static MVEntry[] FindMVEntries (
    String attributeName, 
    byte[] value
)

public static function FindMVEntries (
    attributeName : String, 
    value : byte[]
) : 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
System.ArgumentNullException	The attributeName or value parameter is null.
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 and throw the stopped-extension-dll-exception if called from the following methods:

• The rules extension object constructor

• The Initialize method

• The Terminate method

• The Initialize method

• The Terminate method

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

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

Reference

Utils Class
Utils Members
Microsoft.MetadirectoryServices Namespace
MVEntry Class

Other Resources

WMI Provider Return Strings