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 used by client applications and is not typically overridden.

The unbind operation removes a binding from a context. It unbinds name from the context. It is used to unregister 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 procedes. However, if this context was originally bound using bind_new_context, then a CORBA::PERSIST_STORE exception is 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.

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.


Related reference
CosNaming in the naming service



Searchable topic ID:   rcor_cnsnc0
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_cnsnc0.html

Library | Support | Terms of Use | Feedback