![]() |
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.