GlobalCatalog.FindOne Method

Definition

Namespace:

System.DirectoryServices.ActiveDirectory

Assembly:

System.DirectoryServices.dll

Package:

System.DirectoryServices v9.0.0-rc.2.24473.5

Finds a single global catalog server.

Overloads

FindOne(DirectoryContext)	Finds a single global catalog server in the specified context.
FindOne(DirectoryContext, LocatorOptions)	Finds a single global catalog server in the specified context, allowing for additional search options.
FindOne(DirectoryContext, String)	Finds a single global catalog server in the specified context and site.
FindOne(DirectoryContext, String, LocatorOptions)	Finds a single global catalog server in the specified context and site, allowing for additional search options.

FindOne(DirectoryContext)

Source:

GlobalCatalog.cs

Finds a single global catalog server in the specified context.

public:
 static System::DirectoryServices::ActiveDirectory::GlobalCatalog ^ FindOne(System::DirectoryServices::ActiveDirectory::DirectoryContext ^ context);

public static System.DirectoryServices.ActiveDirectory.GlobalCatalog FindOne (System.DirectoryServices.ActiveDirectory.DirectoryContext context);

static member FindOne : System.DirectoryServices.ActiveDirectory.DirectoryContext -> System.DirectoryServices.ActiveDirectory.GlobalCatalog

Public Shared Function FindOne (context As DirectoryContext) As GlobalCatalog

Parameters

context

DirectoryContext

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

Returns

GlobalCatalog

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

Exceptions

ActiveDirectoryObjectNotFoundException

No global catalog server was found.

ArgumentException

context is not valid.

ArgumentNullException

context is null.

See also

• DirectoryContext

FindOne(DirectoryContext, LocatorOptions)

Source:

GlobalCatalog.cs

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

public:
 static System::DirectoryServices::ActiveDirectory::GlobalCatalog ^ FindOne(System::DirectoryServices::ActiveDirectory::DirectoryContext ^ context, System::DirectoryServices::ActiveDirectory::LocatorOptions flag);

public static System.DirectoryServices.ActiveDirectory.GlobalCatalog FindOne (System.DirectoryServices.ActiveDirectory.DirectoryContext context, System.DirectoryServices.ActiveDirectory.LocatorOptions flag);

static member FindOne : System.DirectoryServices.ActiveDirectory.DirectoryContext * System.DirectoryServices.ActiveDirectory.LocatorOptions -> System.DirectoryServices.ActiveDirectory.GlobalCatalog

Public Shared Function FindOne (context As DirectoryContext, flag As LocatorOptions) As GlobalCatalog

Parameters

context

DirectoryContext

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

flag

LocatorOptions

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

Returns

GlobalCatalog

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

Exceptions

ActiveDirectoryObjectNotFoundException

No global catalog server was found.

ArgumentException

context or flag is not valid.

ArgumentNullException

context is null.

See also

• DirectoryContext
• LocatorOptions

FindOne(DirectoryContext, String)

Source:

GlobalCatalog.cs

Finds a single global catalog server in the specified context and site.

public:
 static System::DirectoryServices::ActiveDirectory::GlobalCatalog ^ FindOne(System::DirectoryServices::ActiveDirectory::DirectoryContext ^ context, System::String ^ siteName);

public static System.DirectoryServices.ActiveDirectory.GlobalCatalog FindOne (System.DirectoryServices.ActiveDirectory.DirectoryContext context, string siteName);

static member FindOne : System.DirectoryServices.ActiveDirectory.DirectoryContext * string -> System.DirectoryServices.ActiveDirectory.GlobalCatalog

Public Shared Function FindOne (context As DirectoryContext, siteName As String) As GlobalCatalog

Parameters

context

DirectoryContext

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

siteName

String

The name of the site to search for a global catalog server.

Returns

GlobalCatalog

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

Exceptions

ActiveDirectoryObjectNotFoundException

No global catalog server was found.

ArgumentException

context or siteName is not valid.

ArgumentNullException

context or siteName is null.

See also

• DirectoryContext

FindOne(DirectoryContext, String, LocatorOptions)

Source:

GlobalCatalog.cs

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

public:
 static System::DirectoryServices::ActiveDirectory::GlobalCatalog ^ FindOne(System::DirectoryServices::ActiveDirectory::DirectoryContext ^ context, System::String ^ siteName, System::DirectoryServices::ActiveDirectory::LocatorOptions flag);

public static System.DirectoryServices.ActiveDirectory.GlobalCatalog FindOne (System.DirectoryServices.ActiveDirectory.DirectoryContext context, string siteName, System.DirectoryServices.ActiveDirectory.LocatorOptions flag);

static member FindOne : System.DirectoryServices.ActiveDirectory.DirectoryContext * string * System.DirectoryServices.ActiveDirectory.LocatorOptions -> System.DirectoryServices.ActiveDirectory.GlobalCatalog

Public Shared Function FindOne (context As DirectoryContext, siteName As String, flag As LocatorOptions) As GlobalCatalog

Parameters

context

DirectoryContext

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

siteName

String

The name of the site to search for a global catalog server.

flag

LocatorOptions

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

Returns

GlobalCatalog

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

Exceptions

ActiveDirectoryObjectNotFoundException

No global catalog server was found.

ArgumentException

context, siteName, or flag is not valid.

ArgumentNullException

context or siteName is null.

See also

• DirectoryContext
• LocatorOptions