You can use the ACMSDI_FORM_RECORD_BIND structure to locate send
control text and receive control text buffers. Both acmsdi_bind_send_args and
acmsdi_bind_receive_args services contain arguments to specify whether or not
to transfer control text. If you specify to transfer control text, the following
rules apply:
•
ACMSDI_FORM_RECORD_BIND structure for the control text must be
the first one in the array of such structures passed on the call.
•
After the call completes, the record length field (rec_len) contains the send
control text count or the receive control text count instead of the length of
the record.
The following example shows the C language definition of this structure as it
appears in the acmsdi.h file:
typedef struct {
unsigned int buffer_len;
/* length of caller’s record buffer */
unsigned int rec_len;
/* actual length of the form record */
void
*data_record;
unsigned int shadow_buffer_len;
/* length of caller’s shadow buffer */
unsigned int shadow_rec_len;
/* actual length of shadow record */
void
*shadow_record;
} ACMSDI_FORM_RECORD_BIND;
2.5 ACMSDI_CALL_OPTION Union Structure
ACMSDI_CALL_OPTION union is a parameter that is passed to the ACMSDI_
CALL_TASK service to enable TP Desktop Connector functions, such as
optimizing unidirectional workspace traffic on the call to the acmsdi_call_task
client service. The include file ACMSDI.H contains the definition for the
ACMSDI_CALL_OPTION union.
ACMSDI_CALL_OPTION contains several structures with the option variables,
whose values determine the type of option being selected. Specify the values
for the option variable using the following constants defined in the ACMSDI.H
include file:
2–8 TP Desktop Connector Portable API Client Services
