[TIBCO.EMS .NET client library 8.1 documentation]

Lookup up an object (given the name of the object) in the LDAP or TIBCO EMS Naming server

Namespace:  TIBCO.EMS
Assembly:  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

 Copy Code
                 LookupContextFactory contextFactory = new LookupContextFactory();
                 ILookupContext searcher = contextFactory.CreateContext("ldap", table);    
                ConnectionFactory cf = (ConnectionFactory)searcher.Lookup("cn='testConnFact");
            

Exceptions

ExceptionCondition
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.

See Also