acmsdi_poll
4.13 acmsdi_poll
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 forced nonblocking environment to check for completion
of outstanding acmsdi_sign_in, acmsdi_call_task, acmsdi_cancel, and acmsdi_
sign_out requests. The acmsdi_poll call also checks for the arrival of an
exchange step from the back end. (For more information, see Compaq TP
Desktop Connector for ACMS Client Application Programming Guide).
The acmsdi_poll service returns a pointer to the call context acquired from the
user application when the just-completed call was issued. Storage for this 32-
bit integer must exist in the client application’s memory. The client application
can compare this pointer with that returned by the acmsdi_return_pointer
service to identify the completed call. The call context is identified by matching
the values.
Format
acmsdi_poll (submitter_id,
call-context)
Parameters
submitter_id
Type: ACMSDI_SUBMITTER_ID
Access: read
Mechanism: by reference
The submitter_id returned by the acmsdi_sign_in service. The submitter
identifier is used to identify the submitter for which the call is being
issued. The acmsdi_poll service passes the submitter identifier as a read-
only argument. TP Desktop responds with either the message type received
from the back end for that submitter or a return code indicating that there is
no message.
call_context
Type: void *
Access: write
Mechanism: by reference
This call writes the pointer to the call context into this optional parameter.
This context identifies the call message that has arrived from the back end.
4–30 Forced Nonblocking Client Services
