Edit

Share via


Forest.FindAllDiscoverableGlobalCatalogs Method

Definition

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)

Source:
Forest.cs
Source:
Forest.cs
Source:
Forest.cs
Source:
Forest.cs

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

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

Exceptions

The target server is either busy or unavailable.

siteName is an empty string.

siteName is null.

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

Applies to

FindAllDiscoverableGlobalCatalogs()

Source:
Forest.cs
Source:
Forest.cs
Source:
Forest.cs
Source:
Forest.cs

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

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

Exceptions

The target server is either busy or unavailable.

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

Applies to