ApplicationPartition.FindByName(DirectoryContext, String) Method

Definition

Namespace:

System.DirectoryServices.ActiveDirectory

Assembly:

System.DirectoryServices.dll

Package:

System.DirectoryServices v9.0.0-rc.2.24473.5

Source:

ApplicationPartition.cs

Returns an ApplicationPartition object for a given DirectoryContext object and distinguished name.

public:
 static System::DirectoryServices::ActiveDirectory::ApplicationPartition ^ FindByName(System::DirectoryServices::ActiveDirectory::DirectoryContext ^ context, System::String ^ distinguishedName);

public static System.DirectoryServices.ActiveDirectory.ApplicationPartition FindByName (System.DirectoryServices.ActiveDirectory.DirectoryContext context, string distinguishedName);

static member FindByName : System.DirectoryServices.ActiveDirectory.DirectoryContext * string -> System.DirectoryServices.ActiveDirectory.ApplicationPartition

Public Shared Function FindByName (context As DirectoryContext, distinguishedName As String) As ApplicationPartition

Parameters

context

DirectoryContext

A DirectoryContext object that contains the target and credentials to use for the search.

distinguishedName

String

A String that contains the distinguished name of the application partition to search for.

Returns

ApplicationPartition

An ApplicationPartition object that represents the results of the search.

Exceptions

ActiveDirectoryObjectNotFoundException

A target specified in the context parameter could not be found.

-or-

The target is a configuration set and no AD LDS instance was found in that configuration set.

-or-

The target is a forest and the application partition was not found in that forest.

-or-

The target does not host the current application partition.

-or-

No AD LDS instance was found for the application partition.

ActiveDirectoryOperationException

A call to the underlying directory service resulted in an error.

ArgumentNullException

context or distinguishedName is null.

ArgumentException

This exception will occur for any of the following reasons:

• The context parameter is not a valid forest, configuration set, or directory server.

• The distinguishedName has a zero length.

• The distinguishedName parameter is in an invalid format.

See also

• DirectoryContext