Joint Client/Servers

CORBA Programming Reference

get_string_oid

Synopsis

Requests the string version of the ObjectId of the current request.

IDL

string get_string_oid() raises (NotInRequest);

C++ Binding

char* get_string_oid();

JExceptions

NotInRequest

The function was called when the ORB was not in the context of a request (that is, not while the ORB was servicing a request in method code). Do not call this function from client code. It is legal only during the execution of a method of the callback object (that is, the servant).

Description

This operation returns the string version of the ObjectId of the current request.

Return Value

char*

The string version of the ObjectId of the current request. This is the string that was supplied when the object reference was created. The string is meaningful to users only in the case when the object reference was created by the start_persistent_userid function. (That is, the ObjectId created by start_transient and start_persistent_systemid were created by the ORB and has no relationship to the user application.)