Joint Client/Servers

CORBA Programming Reference

stop_object

Synopsis

Tells the ORB to stop accepting requests on the object that is using the given servant.

IDL

void stop_object( in PortableServer::Servant servant);

C++ Binding

void stop_object(PortableServer::Servant servant);

Argument

servant

An instance of the C++ implementation class for the interface. The association between this servant and its ObjectId will be removed from the Active Object Map.

Exceptions

None.

Description

This operation tells the ORB to stop accepting requests on the given servant. It does not matter what state the servant is in, activated or deactivated; no error is reported.

Note: If you do an invocation on a callback object after you call the stop_object operation, the OBJECT_NOT_EXIST exception is returned to the caller. This is because the stop_object operation, in effect, deletes the object.

Return Value

None.