![]() | ![]() |
Home |
|
|
Open Client Client-Library/C Reference Manual |
|
| Chapter 2 Topics |
|
| Callbacks |
|
| Restrictions on Client-Library calls in callbacks |
All callback routines are limited as to which Client-Library routines they can call, as indicated in Table 2-2:
Callback type | Callable routines | Permitted use |
All callback routines | ct_config | To retrieve information only. |
ct_con_props | To retrieve information or to set the CS_USERDATA property only. | |
ct_cmd_props | To retrieve information only. The CS_USERDATA property can be set on command structures allocated with ct_cmd_alloc. The CS_USERDATA property cannot be set on command structures obtained by the call's to ct_con_props(CS_EED_CMD) or ct_con_props(CS_NOTIF_CMD). | |
ct_cancel(CS_CANCEL_ATTN) | ||
Server message | ct_bind, ct_describe, ct_fetch, ct_get_data, ct_res_info | The routines must be called with the command structure returned by the callback's ct_con_props(CS_EED_CMD) call. |
Notification | ct_bind, ct_describe, ct_fetch, ct_get_data, ct_res_info(CS_NUMDATA) | The routines must be called with the command structure returned by the callback's ct_con_props(CS_NOTIF_CMD) call. This command structure allows the application to retrieve parameter values associated with the notification event. See "Registered procedures". |
Completion | Any Client-Library or CS-Library routine except cs_objects(CS_SET), ct_init, ct_exit, ct_poll, ct_setloginfo, and ct_getloginfo. | cs_objects(CS_SET) is not asynchronous-safe, and ct_init, ct_exit, ct_setloginfo, and ct_getloginfo perform system-level memory allocation or deallocation, and should not be used. |
Directory | To drop or inspect a directory object. |
|
|