Next: Low Level PEN
Up: RCB_REGISTERCALLBACK(whatcallback,extra)
Previous: RCB_REGISTERCALLBACK(whatcallback,extra)
The high level PEN callback functions allows you to install a
specific callback function for each class of PEN (see
section 7 for a detailed description). The low level
interface is used for building this, e.g. by using the low level
interface to PEN you will effectively disable the high level
interface. In normal cases the high level interface will be
sufficient. We have the following different high level
event:
- RCB_RESOLVE when the history node given by
index was merged from a parallel update, see
section 4.7.
- RCB_CHECK the object given by index
is being editing by user(s) specified in msg.
- RCB_POLL user msg begin editing object
index.
The call format of the callback function is:
(*callback)(void *extra, int index, char *msg);
where the argument have the following declaration and content:
- void *extra
is passed in to the LIBLINCKS function as an extra
application program parameter. It is not used within
LIBLINCKS, and is intended as a pointer to a call block
for application program arguments.
- int index
is the node index to the object sent to the database
(see section 4.3).
- char *msg
is an extra paramter string allocated by LIBLINCKS
and should not be free by you.
It contains (currently) a list of user(s) id.
The function returns the previous callback function, if any.
Martin Sjolin
Thu Jun 15 20:41:59 MET DST 1995