User`s guide

cxlii Contents
Write Structured Fields—Function 127
This function writes structured field data from the Windows HLLAPI application to the host
application.
If the call specifies asynchronous (A), the application receives control as soon as the request has been
successfully queued to the subsystem. If the call specifies synchronous (S), WinHLLAPI waits for the
host to acknowledge receipt of data before returning control to the application
The application provides the buffer address from which data is sent to the host. The buffer must be
obtained using the Allocate Communications Buffer (123) function call.
Prerequisite Functions
Connect Structured Fields (function 120).
Allocate Communications Buffer (function 123).
WinHLLAPI(WRITESTRFLDS,lpbyString,lpwLength,lpwReturnnCode)
Parameter Description
Data String An 8-byte string for synchronous, or a 14-byte string for
asynchronous in the following format:
Byte 1 A 1-character session short name.
Bytes 2 A 1-character specifying the control
option:
u S (synchronous control) - control is
not returned to the application until
the read is satisfied.
u
A (asynchronous control) - control is
returned immediately to the
application.
Bytes 3-4 The 16-bit word unique
destination/origin ID returned by the
Connect Structured Fields (120)
function call.
Bytes 5-8 The 4-byte value of the buffer address
into which the data is to be read. The
buffer must be obtained using the
Allocate Communications Buffer (123)
function call.
Data Length Must be 8 or 14.
PS Position NA.
Parameter Description
Data String When the A (asynchronous) control option is specified
and the request is successfully completed, the following
are returned:
Function Call
Call Parameters
Return Parameters