Compaq AAPVNFGTE Computer Accessories User Manual


 
acmsdi_poll
For example, if an acmsdi_call_task completion message is sent from the back
end, this is a pointer to the context supplied on the acmsdi_call_task call.
This pointer to a structure in the client application’s memory is treated as
a 32-bit integer. To determine the structure being referenced, the client
application compares this value with the values returned by the acmsdi_
return_pointer service. Because data can be moved by memory management,
acmsdi_return_pointer calls must be issued within the same procedure as the
original call.
Return Status
The status values returned by the acmsdi_poll service are listed in Table 4–13.
Table 4–13 acmsdi_poll Return Status Values
Status Description
ACMSDI_CANCEL_DONE Task cancel call complete.
ACMSDI_DONE Sign-in, sign-out, or task call complete.
ACMSDI_ENABLE_EXCH Enable exchange step has arrived.
ACMSDI_EXCHACTV Request is invalid while exchange step
processing is active.
ACMSDI_EXEC No message from the back-end
available; call still executing.
ACMSDI_INSUFPRM Insufficient or conflicting parameters.
ACMSDI_INVSUBID Invalid or obsolete submitter
identification.
ACMSDI_INTERNAL Internal TP Desktop Connector error.
ACMSDI_MIXEDMODE Not a forced nonblocking session call.
ACMSDI_NOMEMORY Insufficient memory.
ACMSDI_READY No message from the back-end
available; no call executing.
ACMSDI_RECV_EXCH Receive exchange step has arrived.
ACMSDI_REQUEST_EXCH TDMS Request exchange step has
arrived.
ACMSDI_SEND_EXCH Send exchange step has arrived.
(continued on next page)
Forced Nonblocking Client Services 4–31