Compaq TP DESKTOP CONNECTOR AAPVNFGTE User Manual

Page 45

Advertising
background image

acmsdi_sign_in

options

Type: ACMSDI_OPTION array
Access: read
Mechanism: by reference
Union containing multiple structures and an option variable, the value of
which defines the type of option being selected (see Section 2.5.1).

submitter_id

Type: ACMSDI_SUBMITTER_ID
Access: write
Mechanism: by reference
A structure into which the acmsdi_sign_in service writes a newly created
submitter identification. Other services use the submitter identification as
a handle to identify an active submitter. The ACMSDI_SUBMITTER_ID
structure is defined in the ACMSDI.H include file.

completion_status

Type: int
Access: write
Mechanism: by reference
The final status of the service. In the blocking environment, the completion_
status
parameter is set to zero when the service starts successfully.

When the service completes, completion_status contains the final status. See
Table 2–6 for a list of return status values.

completion_routine

Type: function address

1

Access: read
Mechanism: by value
Address of a function to be called when the nonblocking service completes. The
completion routine is called by the acmsdi_dispatch_message service when the
reply 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 application-specific context
for the call.

1

For nonblocking only, see Section 2.3. Not applicable to forced nonblocking and will
cause an error if supplied.

TP Desktop Connector Portable API Client Services 2–27

Advertising