Compaq TP DESKTOP CONNECTOR AAPVNFGTE User Manual

Page 34

Advertising
background image

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

Advertising