[Enterprise Extensions only]

NamingContext::list

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


Intended Usage

This operation is intended to be 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).

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