Query Field Attribute – Function 14

This function returns the attribute byte of the field containing the specified position in the Host session presentation space.

Prerequisite functions

Connect Presentation Space (function 1)

Function call

WinHLLAPI(QUERYFIELDATTRIBUTE,lpbyString,lpwLength,lpwReturnnCode)

Call parameters

Parameter	Description
Data String	NA
Data Length	NA
PS Position	A position in the Host session presentation space that is within the field for which you want the attribute byte returned.

Return parameters

Parameter	Description
Data String	The attribute value if the screen is formatted. Zero if the screen is not formatted.

Return code

Code	Description
WHLLOK	Field attribute found successfully.
WHLLNOTCONNECTED	Your Windows HLLAPI application is currently not connected to a session.
WHLLPOSITIONERROR	Invalid value specified for PS Position.
WHLLSYSERROR	The function failed due to a system error.
WHLLNOFIELD	Field attribute not found due to unformatted Host session presentation space.

Remarks

Position in the Host session presentation space is determined by starting in the upper left corner of the screen display (row 1, column 1). At the end of each screen display row, the next Host session presentation space position is column 1 of the following screen display row. This process continues until the end of the Host session presentation space (screen display) is reached.

You must examine the attribute byte to determine all of the current field attributes.