6.49 LceReceiveSelect
Performs the data transfer, from the host to the PC, from a file of one or more records which have been identified by an LceRequestSelect or an LceRequestSelectWhere function.
|
BOOL |
LceReceiveSelect |
(int |
iSession, |
|
|
|
char far * |
strFileName ) |
Parameters
|
iSession |
The session identifier as returned by LceGetSessionId. |
|
strFileName |
The name of the file. This name must correspond to the file name used in the preceding LceRequestSelect or LceRequestSelectWhere function. |
Return Values
TRUE is returned if the session has received the selected records.
FALSE is returned if an error occurs.
Notes
This 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 function.
- LceRequestSelect or LceRequestSelectWhere 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 and following an LceRequestSelect function.
Related Functions