[Enterprise Extensions only]

NamingContext::unbind

Overview Removes a name-object binding.
Original interface CosNaming::NamingContext Interface
Exceptions CORBA standard exceptions and the following user exceptions:
  • CosNaming::NamingContext::CannotProceed
  • CosNaming::NamingContext::InvalidName
  • CosNaming::NamingContext::NotFound


Intended Usage

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

The unbind operation removes a binding from a context. It unbinds the name name from the context. It is used to unregister the name name with the Naming Service.

This operation can also be used to unbind a naming context. If the naming context was originally bound using bind_context, rebind_context, bind, or rebind, the operation will be allowed to proceed. However, if this context was originally bound using bind_new_context, then a CORBA::PERSIST_STORE exception will be thrown since this request would result in an orphaned name context (which is not supported). In the case of the CORBA::PERSIST_STORE exception, the user is required to call the destroy method to unbind the name context.

IDL Syntax

  void unbind(in CosNaming::Name name);

Input parameters

name
The name for the name-object binding.

Return values

None.

Example

See the CosNaming Usage example for BindingIterator::destroy.