Edit

Share via


ApplicationPartition.FindByName(DirectoryContext, String) Method

Definition

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

An ApplicationPartition object that represents the results of the search.

Exceptions

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.

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

context or distinguishedName is null.

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.

Applies to

See also