Edit

ActiveDirectorySite.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.3.24172.9
Source:
ActiveDirectorySite.cs
Source:
ActiveDirectorySite.cs
Source:
ActiveDirectorySite.cs
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.

Applies to

See also