User`s guide

cxxxiv Contents
Read Structured Fields—Function 126
This function receives structured field data from the host application.
If the call specifies asynchronous (A), the application receives control immediately after the call, even if
host data is not available. If the call specifies synchronous (S), WinHLLAPI waits for host data to
become available before returning control to the application.
The application provides the buffer address in which data from the host is to be placed. 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(READSTRFLDS,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.
Byte 2 A 1-character specifying the control
option
S (synchronous control) - control is not
returned to the application until the read
is satisfied.
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.
Function Call
Call Parameters