ActiveDirectorySiteLinkBridge.FindByName 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.
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)
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
A ActiveDirectorySiteLinkBridge object. null
if the object was not found.
Exceptions
In the context
parameter that was specified, the site link bridge could not be found for the given bridgeName
parameter.
A call to the underlying directory service resulted in an error.
The target server is either busy or unavailable.
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.
The context
or the bridgeName
parameter is null
.
See also
Applies to
FindByName(DirectoryContext, String, ActiveDirectoryTransportType)
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
A ActiveDirectorySiteLinkBridge object. null
if the object was not found.
Exceptions
In the context
parameter that was specified, the site link bridge could not be found for the given bridgeName
parameter.
A call to the underlying directory service resulted in an error.
The target server is either busy or unavailable.
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.
The context
or the bridgeName
parameter is null
.
The transport
parameter is not a valid ActiveDirectoryTransportType value.