DomainController.FindOne Method (DirectoryContext, String, LocatorOptions)

Finds a single domain controller in the specified context and site, allowing for additional search options.

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

public static DomainController FindOne(
	DirectoryContext context,
	string siteName,
	LocatorOptions flag
)

Parameters

context
Type: System.DirectoryServices.ActiveDirectory.DirectoryContext

A DirectoryContext object that contains the target and credentials to use for the search.

siteName
Type: System.String

The name of the site to search for a domain controller.

flag
Type: System.DirectoryServices.ActiveDirectory.LocatorOptions

A combination of one or more of the LocatorOptions members that defines the type of domain controller to find.

Return Value

Type: System.DirectoryServices.ActiveDirectory.DomainController
A DomainController object that represents the domain controller that was found by the search.

ExceptionCondition
ActiveDirectoryObjectNotFoundException

No domain controller was found.

ArgumentException

context, siteName, or flag is not valid.

ArgumentNullException

context or siteName is null.

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

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

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

Community Additions

ADD
Show:
© 2014 Microsoft