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
