6.38 LceGetSelect
Retrieves the specified fields with the values in the given record from the previous LceReceiveSelect.
|
BOOL |
LceGetSelect |
(int |
iSession, |
|
|
|
char far * |
strFileName, |
|
|
|
int |
iRecord, |
|
|
|
char far * |
strFieldList ) |
Parameters
|
iSession |
The session identifier as returned by LceGetSessionId. |
|
strFileName |
The name of the file. This name must be the same as the file name used in the preceding LceReceiveSelect function. |
|
iRecord |
The required, or next, record number. This number indicates which record is to be retrieved from the file. This value must not be greater than the value returned by the LceGetRecordCount function. |
|
strFieldList |
A list of fields to be retrieved from the file. This list must be based on the initial list defined in the LceRequestSelect or LceSelect function. The list may be a subset. You do not have to retrieve all the fields which were requested but you cannot request a field which was not defined in the LceRequestSelect. |
Return Values
TRUE is returned if the session selected the records.
FALSE is returned if an error occurs.
Notes
Use the LceGetFieldValueX/LceGetFieldValueU function to obtain the value of a specific field.
The LceGetSelect function is used with a number of other select processing functions. The general pattern of these functions is as follows:
- LceSetSelectOptions sets the selection search characteristics. The *RECEIVEIMMED option cannot be used with this group of functions.
- LceRequestSelect selects records on the host.
- LceReceiveSelect transfers the records from the host to the PC.
- LceGetRecordCount determines how many records were transferred.
- LceGetSelect retrieves a single record from the group of records transferred.
- This function can only be executed after a session has been opened.
Related Functions