GlobalCatalog.FindOne Method (DirectoryContext, LocatorOptions)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Finds a single global catalog server in the specified context, allowing for additional search options.

Namespace:   System.DirectoryServices.ActiveDirectory
Assembly:  System.DirectoryServices (in System.DirectoryServices.dll)

public static GlobalCatalog FindOne(
	DirectoryContext context,
	LocatorOptions flag
)

Parameters

context
Type: System.DirectoryServices.ActiveDirectory.DirectoryContext

A DirectoryContext object that contains the target and credentials to use for the search.

flag
Type: System.DirectoryServices.ActiveDirectory.LocatorOptions

A combination of one or more of the LocatorOptions members that defines the type of global catalog server to find.

Return Value

Type: System.DirectoryServices.ActiveDirectory.GlobalCatalog

A GlobalCatalog object that represents the global catalog server found by the search.

Exception Condition
ActiveDirectoryObjectNotFoundException

No global catalog server was found.

ArgumentException

context or flag is not valid.

ArgumentNullException

context is null.

.NET Framework
Available since 2.0
Return to top
Show: