Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

ActiveDirectorySite.FindByName Method

Returns a site based on a site name.

Namespace: System.DirectoryServices.ActiveDirectory
Assembly: System.DirectoryServices (in system.directoryservices.dll)

public static ActiveDirectorySite FindByName (
	DirectoryContext context,
	string siteName
)
public static ActiveDirectorySite FindByName (
	DirectoryContext context, 
	String siteName
)
public static function FindByName (
	context : DirectoryContext, 
	siteName : String
) : ActiveDirectorySite
Not applicable.

Parameters

context

An DirectoryContext object that is valid for this site.

siteName

The name of the site to find.

Return Value

An ActiveDirectorySite object for the requested site.

Exception typeCondition

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

This exception will occur for any one of the following reasons:

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

  • siteName is an empty string.

ArgumentNullException

context or siteName is a null reference (Nothing in Visual Basic).

AuthenticationException

The credentials that were supplied are not valid.

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2015 Microsoft