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.

Exception Condition
ActiveDirectoryObjectNotFoundException

No domain controller was found.

ArgumentException

context, siteName, or flag is not valid.

ArgumentNullException

context or siteName is null.

.NET Framework
Available since 2.0
Return to top
Show: