acmsdi_dispatch_message
2.9 acmsdi_dispatch_message
TP Desktop Connector client programs call this nonblocking service to check
for and process messages sent from a TP Desktop Connector gateway to an
active submitter in the desktop application. The application must periodically
call this service in a nonblocking environment to check for completion of
outstanding acmsdi_sign_in, acmsdi_call_task, and acmsdi_sign_out requests.
If no TP Desktop Connector messages are received, the service returns
immediately. If a TP Desktop Connector message is received, the service
calls the appropriate completion routine or presentation procedure and then
returns (see Compaq TP Desktop Connector for ACMS Client Application
Programming Guide.
Note that this call is not used in the forced nonblocking environment. See
Section 4.13.
Format
acmsdi_dispatch_message ( )
Parameters
No parameters are specified.
Return Status
The status values returned by the acmsdi_dispatch_message service are listed
in Table 2–5.
Table 2–5 acmsdi_dispatch_message Return Status Values
Status
Description
ACMSDI_INTERNAL
Internal TP Desktop Connector error.
ACMSDI_NOMEMORY
Insufficient memory.
(continued on next page)
TP Desktop Connector Portable API Client Services 2–23
