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

6.64 LceSetSelectOptions

6.50 LceRequestSelect

6.51 LceRequestSelectWhere

6.37 LceGetRecordCount

6.38 LceGetSelect

6.53 LceSelect

6.11 LceDeleteSelect