NBS.TCP_Read (FB)

This function block of the CAA_NetBaseServices.library serves to read data from the previously established connection given in hConnection. As long as xEnable is TRUE the handle of the connection is valid. The pointer pData specifies the memory area to write the read data to. szSize defines the max number of bytes to read. When the data was read successfully, xReady is set to TRUE and szCount indicates the actually read number of bytes.

Input:

xEnable

BOOL

see: “CAA 指南”

hConnection

CAA.HANDLE

Handle of the connection

szSize

CAA.SIZE

Maximum number of bytes to be read; can be retrieved via operator SIZEOF

pData

CAA.PVOID

Target address for the first byte to be read; can be retrieved via operator ADR

Output:

xDone

BOOL

see: “CAA 指南”

xBusy

BOOL

see: “CAA 指南”

xError

BOOL

see: “CAA 指南”

eError

NBS.ERROR

Error id

xReady

BOOL

TRUE: Data received

FALSE: No data received

szCount

CAA.SIZE

Size of the received data