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
Return values
None.
Example
See the CosNaming Usage example for BindingIterator::destroy.