ActiveDirectorySiteLinkBridge.FindByName Method

Definition

Namespace:

System.DirectoryServices.ActiveDirectory

Assembly:

System.DirectoryServices.dll

Package:

System.DirectoryServices v9.0.0-rc.2.24473.5

Gets a ActiveDirectorySiteLinkBridge object that matches a given name.

Overloads

FindByName(DirectoryContext, String)	Gets a ActiveDirectorySiteLinkBridge object that matches a given directory context and name for the RPC transport protocol only.
FindByName(DirectoryContext, String, ActiveDirectoryTransportType)	Gets a ActiveDirectorySiteLinkBridge object that matches a given directory context, name, and transport type.

FindByName(DirectoryContext, String)

Source:

ActiveDirectorySiteLinkBridge.cs

Gets a ActiveDirectorySiteLinkBridge object that matches a given directory context and name for the RPC transport protocol only.

public:
 static System::DirectoryServices::ActiveDirectory::ActiveDirectorySiteLinkBridge ^ FindByName(System::DirectoryServices::ActiveDirectory::DirectoryContext ^ context, System::String ^ bridgeName);

public static System.DirectoryServices.ActiveDirectory.ActiveDirectorySiteLinkBridge FindByName (System.DirectoryServices.ActiveDirectory.DirectoryContext context, string bridgeName);

static member FindByName : System.DirectoryServices.ActiveDirectory.DirectoryContext * string -> System.DirectoryServices.ActiveDirectory.ActiveDirectorySiteLinkBridge

Public Shared Function FindByName (context As DirectoryContext, bridgeName As String) As ActiveDirectorySiteLinkBridge

Parameters

context

DirectoryContext

A DirectoryContext object that specifies the context for the search.

bridgeName

String

A String that specifies the name of the ActiveDirectorySiteLinkBridge object to search for.

Returns

ActiveDirectorySiteLinkBridge

A ActiveDirectorySiteLinkBridge object. null if the object was not found.

Exceptions

ActiveDirectoryObjectNotFoundException

In the context parameter that was specified, the site link bridge could not be found for the given bridgeName parameter.

ActiveDirectoryOperationException

A call to the underlying directory service resulted in an error.

ActiveDirectoryServerDownException

The target server is either busy or unavailable.

ArgumentException

This exception will occur for any of the following reasons.

• The target in the context parameter is not a forest, configuration set, domain controller, or an AD LDS server.

• The bridgeName parameter is an empty string.

ArgumentNullException

The context or the bridgeName parameter is null.

See also

• DirectoryContext

FindByName(DirectoryContext, String, ActiveDirectoryTransportType)

Source:

ActiveDirectorySiteLinkBridge.cs

Gets a ActiveDirectorySiteLinkBridge object that matches a given directory context, name, and transport type.

public:
 static System::DirectoryServices::ActiveDirectory::ActiveDirectorySiteLinkBridge ^ FindByName(System::DirectoryServices::ActiveDirectory::DirectoryContext ^ context, System::String ^ bridgeName, System::DirectoryServices::ActiveDirectory::ActiveDirectoryTransportType transport);

public static System.DirectoryServices.ActiveDirectory.ActiveDirectorySiteLinkBridge FindByName (System.DirectoryServices.ActiveDirectory.DirectoryContext context, string bridgeName, System.DirectoryServices.ActiveDirectory.ActiveDirectoryTransportType transport);

static member FindByName : System.DirectoryServices.ActiveDirectory.DirectoryContext * string * System.DirectoryServices.ActiveDirectory.ActiveDirectoryTransportType -> System.DirectoryServices.ActiveDirectory.ActiveDirectorySiteLinkBridge

Public Shared Function FindByName (context As DirectoryContext, bridgeName As String, transport As ActiveDirectoryTransportType) As ActiveDirectorySiteLinkBridge

Parameters

context

DirectoryContext

A DirectoryContext object that specifies the context for the search.

bridgeName

String

A String that specifies the name of the ActiveDirectorySiteLinkBridge object to search for.

transport

ActiveDirectoryTransportType

A ActiveDirectoryTransportType value that specifies the transport type of the object to search for.

Returns

ActiveDirectorySiteLinkBridge

A ActiveDirectorySiteLinkBridge object. null if the object was not found.

Exceptions

ActiveDirectoryObjectNotFoundException

In the context parameter that was specified, the site link bridge could not be found for the given bridgeName parameter.

ActiveDirectoryOperationException

A call to the underlying directory service resulted in an error.

ActiveDirectoryServerDownException

The target server is either busy or unavailable.

ArgumentException

This exception will occur for any of the following reasons:

• The target in the context parameter is not a forest, configuration set, domain controller, or an AD LDS server.

• The bridgeName parameter is an empty string.

ArgumentNullException

The context or the bridgeName parameter is null.

InvalidEnumArgumentException

The transport parameter is not a valid ActiveDirectoryTransportType value.

See also

• ActiveDirectoryTransportType
• DirectoryContext