CX_CORBA_MANAGER::SetName

CX_CORBA_MANAGER::SetName

Description:

Registers the local instance with the Corba Namingservice under the given name. Only the last part of the schema "ClassiX"/<Project>/"RemoteMsg"/<Name> has to be specified as the name of the recipient. The Parent Naming Context ("ClassiX") and the name of the interface ("RemoteMsg") are completed internally. If the new name differs from the previous one, the old name binding is removed. If you want to register a name that is identical to an existing name, you can either overwrite the existing name binding or keep it.

A status code is returned indicating which operations have been performed. Where the value

0 that the desired name has been successfully registered and the old name of this instance has been removed,

-1 that an old bond existed which was retained,

-2 that the desired name was registered, but removing the old name failed.

Other return values indicate an error after which it is unclear how the naming service was modified.

Code example:

Function call: Call(SetName)