ActiveDirectorySite.FindByName(DirectoryContext, String) Method

Reference

Definition

Namespace:: System.DirectoryServices.ActiveDirectory

Assembly:: System.DirectoryServices.dll

Package:: System.DirectoryServices v8.0.0

Package:: System.DirectoryServices v9.0.0-rc.2.24473.5

Source:: ActiveDirectorySite.cs

Source:: ActiveDirectorySite.cs

Source:: ActiveDirectorySite.cs

Source:: ActiveDirectorySite.cs

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 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.

Applies to

Del via