Understanding Verb Record Contents
Although structured differently, the three types of verb records
all provide fields for the following parameters:
- Operation
- A number specifying the particular operation to be done. Symbolic
names for operations are declared in the
_cons.h
include files. - Verb record length
- The size of the verb record, which can vary from operation to operation, and which LUA needs in order to process the record.
- Session identifier
- In communication and service verbs, a number to identify the session or the name of the session.
- Primary return code
- A number returned by LUA to indicate general success or failure.
- Secondary return code
- A number returned by LUA on a failure to indicate the specific problem.
- Correlator
- A long integer that your application can use to relate the verb record to other data, or to identify the verb record during an asynchronous completion.
- Post handle
- The event handle to be posted when the verb completes asynchronously.
For Windows NT®, Windows® 2000, and Windows® 98, this should be an event handle. In Windows® 3.1, this should be a window handle. For OS/2®, this should be a semaphore handle.
Most of these fields have the identical data type and are at the identical offset in every verb record in which they appear. The operation code and verb-length fields have different characteristics, however.