Computer Accessories User Manual

acmsdi_complete_call
A structure defined in the ACMSDI.H include file into which the acmsdi_call_
task service writes a newly created call identification, a handle used by the
TP Desktop Connector client services to identify an active call for a submitter.
This parameter is required when completing an acmsdi_call_task service.
status_message
Type: char *
Access: write
Mechanism: by reference
A buffer to receive the message text associated with the task completion status.
The message text returned is either the text associated with a TP Desktop
Connector error or the message text returned from a ACMS application.
Required length is 80. You use this parameter only for the acmsdi_call_task
service completion.
Caution
If the full space is not allocated, the TP Desktop Connector client
services write past the end of the allocated string and can cause the
application to fail. Ensure that the desktop client program allocates
the required length of space.
workspaces
Type: ACMSDI_WORKSPACE or ACMSDI_WORKSPACE_OPT array
Access: write
Mechanism: by reference
One or more optional workspaces passed to the application from the back end.
You need to typecast your array to void *. The workspaces must be specified in
the same order as they are declared in the task definition, and must match the
number specified in the workspace_count parameter. If you use the ACMSDI_
WORKSPACE_OPT type, you must set the call_options parameter to allow
unidirectional workspaces.
Because buffers may have been relocated by memory management, workspace
pointers in the structures must be renewed using the acmsdi_return_pointer
call just prior to issuing acmsdi_complete_call.
You use this parameter only for the acmsdi_call_task service completion.
Forced Nonblocking Client Services 4–5