NamingContext::list

Overview Retrieves bindings from a naming context.
Original interface CosNaming::NamingContext Interface
Exceptions CORBA standard exceptions


Intended Usage

This operation is used by client applications. It is not typically overridden.

This operation retrieves bindings from a naming context. At most, the operation returns a number of bindings equal to how_many in blist. If the naming context contains additional bindings, a BindingIterator is returned, and the calling program can iterate through the remaining bindings. If the naming context does not contain additional bindings, the BindingIterator is a NIL object reference.

The value of how_many should be less than or equal to a maximum of 1000.

The returned binding list is of type BindingList which contains a list of bindings. Each element in the list is of type Binding. Binding consists of two fields: binding_name which is the name part of the binding and binding_type which is the type of the object part of the binding. A binding type is either an object (nobject) or a naming context (ncontext).

Syntax

  void list(
    in unsigned long how_many,
    out CosNaming::BindingList blist,
    out CosNaming::BindingIterator biterator);

Input parameters

how_many
The maximum number of bindings to install into the BindingList.
blist
The returned BindingList.
biterator
The returned BindingIterator.

Return values

None.

Example

See the CosNaming Usage example for BindingIterator::destroy.


Related reference
CosNaming in the naming service



Searchable topic ID:   rcor_cnsnc5
Last updated: Jun 21, 2007 8:07:48 PM CDT    WebSphere Business Integration Server Foundation, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.wasee.doc/info/ee/corba/ref/rcor_cnsnc5.html

Library | Support | Terms of Use | Feedback