acmsdi_complete_call
4.2 acmsdi_complete_call
The acmsdi_complete_call service is a required call that obtains completion
arguments for acsmdi_call_task, acsmdi_sign_in, acmsdi_sign_out, and
acmsdi_cancel services. When acmsdi_poll detects completion,
acmsdi_complete_call can obtain the completion status for these services. The
acmsdi_complete_call can also obtain the ACMS status message and task
argument workspaces sent from the back end for the acmsdi_call_task service.
Format
acmsdi_complete_call (submitter_id,
completion_status,
[call_id],
[status_message],
[workspaces])
Parameters
submitter_id
Type: ACMSDI_SUBMITTER_ID
Access: read
Mechanism: by reference
The submitter_id returned by the acmsdi_sign_in service.
completion_status
Type: int
Access: write
Mechanism: by reference
The final status of the TP Desktop Connector client service. When the service
completes, the completion_status parameter contains the final status. For the
list of return status values, see Table 4–2.
When a task is canceled, the TP Desktop Connector gateway reports a specific
error, where possible. If the gateway cannot convert a ACMS error to a specific
TP Desktop Connector status, it returns ACMSDI_TASK_FAILED to the
desktop client program.
call_id
Type: ACMSDI_CALL_ID *
Access: read
Mechanism: by reference
4–4 Forced Nonblocking Client Services
