Collapse All Expand All

.NET Framework Class Library
ILookupContext Interface Example See Also

[TIBCO.EMS .NET client library 5.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

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.

# See Also

ILookupContext Interface
TIBCO.EMS Namespace