_lread

Syntax

int _lread(hFile,lpBuffer,wBytes)

This function reads data from the file identified by the hFile parameter. The wBytes parameter specifies the number of bytes to read. The function return value indicates the number of bytes actually read. The return value is zero if the function attempted to read the file at EOF.

Parameter Type/Description  

hFile int Specifies the MS-DOS file handle of the file to be read.  
lpBuffer LPSTR Points to a buffer that is to receive the data read from the file.  
wBytes WORD Specifies the number of bytes to be read from the file.  

Return Value

The return value indicates the number of bytes which the function actually read from the file, or –1 if the function fails. The return value is less than wBytes if the function encountered the end of the file (EOF) before reading the specified number of bytes.