ActiveDirectorySite.FindByName(DirectoryContext, String) Method

Definition

Namespace:

System.DirectoryServices.ActiveDirectory

Assembly:

System.DirectoryServices.dll

Source:

ActiveDirectorySite.cs

Returns a site based on a site name.

public:
 static System::DirectoryServices::ActiveDirectory::ActiveDirectorySite ^ FindByName(System::DirectoryServices::ActiveDirectory::DirectoryContext ^ context, System::String ^ siteName);

public static System.DirectoryServices.ActiveDirectory.ActiveDirectorySite FindByName (System.DirectoryServices.ActiveDirectory.DirectoryContext context, string siteName);

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

Public Shared Function FindByName (context As DirectoryContext, siteName As String) As ActiveDirectorySite

Parameters

context

DirectoryContext

An DirectoryContext object that is valid for this site.

siteName

String

The name of the site to find.

Returns

ActiveDirectorySite

An ActiveDirectorySite object for the requested site.

Exceptions

ActiveDirectoryObjectNotFoundException

The site could not be found for the given siteName in the context specified.

ActiveDirectoryOperationException

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

ActiveDirectoryServerDownException

The target server is either busy or unavailable.

ArgumentException

The target in the context parameter is not a forest, configuration set, domain controller, or an AD LDS server.

-or-

siteName is an empty string.

ArgumentNullException

context or siteName is null.

AuthenticationException

The credentials that were supplied are not valid.

See also

• DirectoryContext