Domain.FindDomainController Method

Definition

Namespace:

System.DirectoryServices.ActiveDirectory

Assembly:

System.DirectoryServices.dll

Finds any domain controller in this domain.

Overloads

FindDomainController()	Finds any domain controller in this domain.
FindDomainController(LocatorOptions)	Finds a domain controller in this domain that meets the specified criteria.
FindDomainController(String)	Finds a domain controller in this domain and in the specified site.
FindDomainController(String, LocatorOptions)	Finds a domain controller in this domain and in the specified site that meets the specified criteria.

FindDomainController()

Finds any domain controller in this domain.

public:
 System::DirectoryServices::ActiveDirectory::DomainController ^ FindDomainController();

public System.DirectoryServices.ActiveDirectory.DomainController FindDomainController ();

member this.FindDomainController : unit -> System.DirectoryServices.ActiveDirectory.DomainController

Public Function FindDomainController () As DomainController

Returns

DomainController

A DomainController that represents the domain controller that is found by this method.

Exceptions

ActiveDirectoryObjectNotFoundException

A domain controller cannot be located.

ActiveDirectoryOperationException

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

ObjectDisposedException

The object has been disposed.

Remarks

This method finds any domain controller in the domain. There is no guarantee that the same domain controller will be found by another call to this method.

See also

• DomainController

FindDomainController(LocatorOptions)

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

public:
 System::DirectoryServices::ActiveDirectory::DomainController ^ FindDomainController(System::DirectoryServices::ActiveDirectory::LocatorOptions flag);

public System.DirectoryServices.ActiveDirectory.DomainController FindDomainController (System.DirectoryServices.ActiveDirectory.LocatorOptions flag);

member this.FindDomainController : System.DirectoryServices.ActiveDirectory.LocatorOptions -> System.DirectoryServices.ActiveDirectory.DomainController

Public Function FindDomainController (flag As LocatorOptions) As DomainController

Parameters

flag

LocatorOptions

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

Returns

DomainController

A DomainController that represents the domain controller that is found by this method.

Exceptions

ActiveDirectoryObjectNotFoundException

A domain controller cannot be located.

ActiveDirectoryOperationException

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

ArgumentException

The flag parameter contains an invalid value.

ObjectDisposedException

The object has been disposed.

See also

• DomainController
• LocatorOptions

FindDomainController(String)

Finds a domain controller in this domain and in the specified site.

public:
 System::DirectoryServices::ActiveDirectory::DomainController ^ FindDomainController(System::String ^ siteName);

public System.DirectoryServices.ActiveDirectory.DomainController FindDomainController (string siteName);

member this.FindDomainController : string -> System.DirectoryServices.ActiveDirectory.DomainController

Public Function FindDomainController (siteName As String) As DomainController

Parameters

siteName

String

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

Returns

DomainController

A DomainController object that represents the domain controller that is found by this method.

Exceptions

ActiveDirectoryObjectNotFoundException

A domain controller cannot be located.

ActiveDirectoryOperationException

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

ArgumentException

siteName is an empty string.

ArgumentNullException

siteName is null.

ObjectDisposedException

The object has been disposed.

See also

• DomainController

FindDomainController(String, LocatorOptions)

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

public:
 System::DirectoryServices::ActiveDirectory::DomainController ^ FindDomainController(System::String ^ siteName, System::DirectoryServices::ActiveDirectory::LocatorOptions flag);

public System.DirectoryServices.ActiveDirectory.DomainController FindDomainController (string siteName, System.DirectoryServices.ActiveDirectory.LocatorOptions flag);

member this.FindDomainController : string * System.DirectoryServices.ActiveDirectory.LocatorOptions -> System.DirectoryServices.ActiveDirectory.DomainController

Public Function FindDomainController (siteName As String, flag As LocatorOptions) As DomainController

Parameters

siteName

String

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

flag

LocatorOptions

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

Returns

DomainController

A DomainController object that represents the domain controller that is found by this method.

Exceptions

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.

See also

• DomainController
• LocatorOptions