Forest.FindAllDiscoverableGlobalCatalogs Method

Definition

Namespace:

System.DirectoryServices.ActiveDirectory

Assembly:

System.DirectoryServices.dll

Finds all of the discoverable global catalogs in this forest.

Overloads

FindAllDiscoverableGlobalCatalogs(String)	Finds all of the discoverable global catalogs in this forest in a specified site.
FindAllDiscoverableGlobalCatalogs()	Finds all of the discoverable global catalogs in this forest.

FindAllDiscoverableGlobalCatalogs(String)

Finds all of the discoverable global catalogs in this forest in a specified site.

public:
 System::DirectoryServices::ActiveDirectory::GlobalCatalogCollection ^ FindAllDiscoverableGlobalCatalogs(System::String ^ siteName);

public System.DirectoryServices.ActiveDirectory.GlobalCatalogCollection FindAllDiscoverableGlobalCatalogs (string siteName);

member this.FindAllDiscoverableGlobalCatalogs : string -> System.DirectoryServices.ActiveDirectory.GlobalCatalogCollection

Public Function FindAllDiscoverableGlobalCatalogs (siteName As String) As GlobalCatalogCollection

Parameters

siteName

String

The name of the site to search.

Returns

GlobalCatalogCollection

A GlobalCatalogCollection that contains the collection of global catalogs that were found.

Exceptions

ActiveDirectoryServerDownException

The target server is either busy or unavailable.

ArgumentException

siteName is an empty string.

ArgumentNullException

siteName is null.

ObjectDisposedException

The object has been disposed.

Remarks

You can find discoverable global catalogs by querying DNS SRV records. If a global catalog does not register a GC SRV record for the specified site, it will not be returned by this method, even if the global catalog is physically located within that site.

All global catalogs which register a GC SRV record for the specified site will be returned by this method, even if they might not be physically located within that site.

See also

• GlobalCatalogCollection

FindAllDiscoverableGlobalCatalogs()

Finds all of the discoverable global catalogs in this forest.

public:
 System::DirectoryServices::ActiveDirectory::GlobalCatalogCollection ^ FindAllDiscoverableGlobalCatalogs();

public System.DirectoryServices.ActiveDirectory.GlobalCatalogCollection FindAllDiscoverableGlobalCatalogs ();

member this.FindAllDiscoverableGlobalCatalogs : unit -> System.DirectoryServices.ActiveDirectory.GlobalCatalogCollection

Public Function FindAllDiscoverableGlobalCatalogs () As GlobalCatalogCollection

Returns

GlobalCatalogCollection

A GlobalCatalogCollection that contains the collection of global catalogs that were found.

Exceptions

ActiveDirectoryServerDownException

The target server is either busy or unavailable.

ObjectDisposedException

The object has been disposed.

Remarks

You can find discoverable domain controllers by querying DNS SRV records. Only global catalogs that register a generic, non-site-specific, GC SRV record are returned by this method.

See also

• GlobalCatalogCollection