Domain.FindDomainController Method (String, LocatorOptions)

 

Finds a domain controller in this domain and in the specified site that meets the specified criteria.

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

public DomainController FindDomainController(
	string siteName,
	LocatorOptions flag
)

Parameters

siteName
Type: System.String

The name of the site to search for the 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 is found by this method.

Exception Condition
ActiveDirectoryObjectNotFoundException

A domain controller cannot be located.

ActiveDirectoryOperationException

A call to the underlying directory service resulted in an error.

ArgumentException

This exception will occur for any of the following reasons.

  • siteName is an empty string.

  • flag contains an invalid value.

ArgumentNullException

siteName is null.

ObjectDisposedException

The object has been disposed.

.NET Framework
Available since 2.0
Return to top
Show: