[TIBCO.EMS .NET client library 8.1 documentation]
Assembly: TIBCO.EMS (in TIBCO.EMS.dll)
Lookup up an object (given the name of the object) in the
LDAP or TIBCO EMS Naming server
Namespace:
TIBCO.EMSAssembly: TIBCO.EMS (in TIBCO.EMS.dll)
Syntax
Object Lookup( string name ) |
Function Lookup ( _ name As String _ ) As Object |
Object^ Lookup( String^ name ) |
Parameters
- name
- Type: System..::.String
Remarks
This method looks up an object in either an LDAP or TIBCO EMS Naming server, depending on which interface is asked for in the LookupContextFactory.
Ldap Related Information
This will first initialize the ldap connection environment if the the context initialized is LDAP context and then searches for the object in the ldap server, constructs the object and returns the object.
At a very high level the lookup function performs a set of tasks for an ldap context.
- Initializes the ldap connection environment, performs various checks to make sure the right parameters are passed in.
- Establishes a LDAP connection to the specified server
- Searches for the specified object in the LDAP server
- Once it receives the XML data for the specified administered object, it performs XML validation through the specified DTD.
- Retrieves the object properties stored as XML.
- Constructs and returns the appropriate objects.
Examples
![]() | |
---|---|
LookupContextFactory contextFactory = new LookupContextFactory(); ILookupContext searcher = contextFactory.CreateContext("ldap", table); ConnectionFactory cf = (ConnectionFactory)searcher.Lookup("cn='testConnFact"); |
Exceptions
Exception | Condition |
---|---|
TIBCO.EMS..::.NamingException | Cannot connect to the ldap server; cannot connect to the TIBCO EMS Naming server if the context is tibjmsnaming context; cannot find the object, or some other exception. |
TIBCO.EMS..::.ConfigurationException | The url, basedn, principal, credential, or any combination of the required parameters are missing. |