Domain.FindDomainController Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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()
- Source:
- Domain.cs
- Source:
- Domain.cs
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.DomainControllerPublic Function FindDomainController () As DomainControllerReturns
A DomainController that represents the domain controller that is found by this method.
Exceptions
A domain controller cannot be located.
A call to the underlying directory service resulted in an error.
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
Applies to
FindDomainController(LocatorOptions)
- Source:
- Domain.cs
- Source:
- Domain.cs
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.DomainControllerPublic Function FindDomainController (flag As LocatorOptions) As DomainControllerParameters
- flag
- LocatorOptions
A combination of one or more of the LocatorOptions members that defines the type of domain controller to find.
Returns
A DomainController that represents the domain controller that is found by this method.
Exceptions
A domain controller cannot be located.
A call to the underlying directory service resulted in an error.
The flag parameter contains an invalid value.
The object has been disposed.
See also
Applies to
FindDomainController(String)
- Source:
- Domain.cs
- Source:
- Domain.cs
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.DomainControllerPublic Function FindDomainController (siteName As String) As DomainControllerParameters
- siteName
- String
The name of the site to search for the domain controller.
Returns
A DomainController object that represents the domain controller that is found by this method.
Exceptions
A domain controller cannot be located.
A call to the underlying directory service resulted in an error.
siteName is an empty string.
siteName is null.
The object has been disposed.
See also
Applies to
FindDomainController(String, LocatorOptions)
- Source:
- Domain.cs
- Source:
- Domain.cs
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.DomainControllerPublic Function FindDomainController (siteName As String, flag As LocatorOptions) As DomainControllerParameters
- 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
A DomainController object that represents the domain controller that is found by this method.
Exceptions
A domain controller cannot be located.
A call to the underlying directory service resulted in an error.
This exception will occur for any of the following reasons.
siteNameis an empty string.flagcontains an invalid value.
siteName is null.
The object has been disposed.
