acmsdi_call_task
completion_routine
Type: function address
1
Access: read
Mechanism: by value
Address of a function to be called when the service completes. The completion_
routine is called by the acmsdi_dispatch_message service when the
"
End of
Task
"
message is received from the TP Desktop Connector gateway.
call_context
Type: void *
Access: read
Mechanism: by value
Optional parameter passed to presentation procedures and completion routines
to identify the call. Use this parameter to supply an application-specific context
for the call.
Return Status
The status values returned by the acmsdi_call_task service are listed in
Table 2–2.
Table 2–2 acmsdi_call_task Return Status Values
Status
Description
ACMSDI_APPLDEAD
Application stopped unexpectedly.
ACMSDI_CALLACTV
Call is already active.
ACMSDI_INSUFPRM
Insufficient parameters.
ACMSDI_INTERNAL
Internal TP Desktop Connector error.
ACMSDI_INVOPTION
Invalid item in options list.
ACMSDI_INVSUBID
Invalid or obsolete submitter identification.
ACMSDI_MIXEDMODE
All calls on a connection must be either
blocking or nonblocking.
ACMSDI_NOMEMORY
Insufficient memory to complete requests.
ACMSDI_NORMAL
Normal successful completion.
ACMSDI_NOSUCH_APPL
Application not found.
(continued on next page)
1
For nonblocking only, see Section 2.3. Not applicable to forced nonblocking and will
cause an error if supplied.
2–16 TP Desktop Connector Portable API Client Services
