Global Functions in Global Namespace C++
in Sourcefile context.h


remote_addContextListener
extern "C"
void remote_addContextListener(
remote_contextListenerFunc listener,
void * pObject );

virtual abstract const volatile template static inline C-linkage
NO NO NO NO NO NO NO YES

Summary
Registers a listener at the context administration, which allows to keep track of existing remote connections.
Parameters
pObject
object which is handed to the listener function, when called.

remote_createContext
extern "C"
remote_Context * remote_createContext(
remote_Connection * pConnection,
rtl_uString * pIdStr,
rtl_uString * pDescription,
rtl_uString * pProtocol,
remote_InstanceProvider * );

virtual abstract const volatile template static inline C-linkage
NO NO NO NO NO NO NO YES

Summary
Create an acquired remote context. The Context is weakly held by the context administration and can be accessed later through remote_getContext() (using the same id-string).
Parameters
pIdString
A string, that uniquely describes the connection. For e.g. a socket connection,
                 host and port of the local and remote host should be in the string.
                 
pDescription
                 Description of the connection, that may brought up to the user.

pProtocol
                 The protocol, that the environment uses for
                 communicating with the remote process.
                 The format of the protocol string is : "protocolname,para1=para1value,..."
Return
0, when a context with this name already exists.
See Also
remote_getContext()
remote_Context

remote_getContext
extern "C"
remote_Context * remote_getContext(
rtl_uString * pIdString );

virtual abstract const volatile template static inline C-linkage
NO NO NO NO NO NO NO YES

Description
Try to get an existing context characterized by the pIdString. Each ID-String must uniquely charcterize a certain connection. The context can't be retrieved via this function anymore, after it got disposed.
Return
0 when such a context does not exist, otherwise a pointer to an acquired remote_Context.

remote_removeContextListener
extern "C"
void remote_removeContextListener(
remote_contextListenerFunc listener,
void * pObject );

virtual abstract const volatile template static inline C-linkage
NO NO NO NO NO NO NO YES

Summary
Removes a listener from the context administration.

Top of Page