Caution
Use the ACMSDI_CALL_OPT_OPTIMIZE_WKSPS option and the
ACMSDI_WORKSPACE_OPT type definition together to optimize
unidirectional workspace traffic. Do not use one without the other.
The acmsdi_call_task client service uses the presence or absence of
the workspace optimization option to decide which data type has been
passed in the workspaces argument. Using either one without the
other produces unpredictable results.
2.5.1 ACMSDI_OPTION Array
ACMSDI_OPTION array is a parameter that is passed to the ACMSDI_
SIGN_IN service to enable TP Desktop Connector functions, such as enabling
password expiration checking on the call to acmsdi_call_task client service.
The include file ACMSDI.H contains the definition for the ACMSDI_OPTION
array.
The ACMSDI_OPTION array is a union containing multiple structures and an
option variable, the value of which defines the type of option being selected.
Specify the values for the option variable using the following constants defined
in the include file ACMSDI.H:
Constant
Description
ACMSDI_OPT_CHECK_VERSION
Enables version checking
ACMSDI_OPT_COMMID
Supplies communications device id or
TCP/IP comm port
ACMSDI_OPT_END_LIST
Ends options list
ACMSDI_OPT_FREE_ROUTINE
Enables user-defined memory deallocation
ACMSDI_OPT_MALLOC_ROUTINE
Enables user-defined memory allocation
ACMSDI_OPT_NONBLK
Enables a forced nonblocking session
ACMSDI_OPT_PWD_EXPIRING
Enables checking for passwords that are
about to expire
2–10 TP Desktop Connector Portable API Client Services
