Forest.FindAllDiscoverableGlobalCatalogs 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 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
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.GlobalCatalogCollectionPublic Function FindAllDiscoverableGlobalCatalogs (siteName As String) As GlobalCatalogCollectionParameters
- 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
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.GlobalCatalogCollectionPublic Function FindAllDiscoverableGlobalCatalogs () As GlobalCatalogCollectionReturns
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.
