Edit

ApplicationPartition.FindByName(DirectoryContext, String) Method

  • Reference

Definition

Namespace:
System.DirectoryServices.ActiveDirectory
Assembly:
System.DirectoryServices.dll
Package:
System.DirectoryServices v6.0.0
Package:
System.DirectoryServices v7.0.0
Package:
System.DirectoryServices v8.0.0
Package:
System.DirectoryServices v9.0.0-preview.2.24128.5
Source:
ApplicationPartition.cs
Source:
ApplicationPartition.cs
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.

Applies to

See also