ApplicationPartition.FindByName(DirectoryContext, String) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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.ApplicationPartitionPublic Shared Function FindByName (context As DirectoryContext, distinguishedName As String) As ApplicationPartitionParameters
- 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
contextparameter is not a valid forest, configuration set, or directory server.The
distinguishedNamehas a zero length.The
distinguishedNameparameter is in an invalid format.
