_lread

The _lread function reads data from the specified file.

Note  This function is provided only for compatibility with 16-bit versions of Windows. Win32-based applications should use the ReadFile function.

UINT _lread(
  HFILE hFile,      // handle to file
  LPVOID lpBuffer,  // pointer to buffer for read data
  UINT uBytes       // length, in bytes, of data buffer
);

Parameters

hFile

[in] Handle to the specified file.

lpBuffer

[out] Pointer to a buffer that contains the data read from the file.

uBytes

[in] Specifies the number of bytes to be read from the file.

Return Values

The return value indicates the number of bytes actually read from the file. If the number of bytes read is less than uBytes, the function has reached the end of file (EOF) before reading the specified number of bytes.

If the function fails, the return value is HFILE_ERROR. To get extended error information, call GetLastError.

If you are attempting to read from a floppy drive that does not have a floppy disk, the system displays a message box prompting the user to retry the operation. To prevent the system from displaying this message box, call the SetErrorMode function with SEM_NOOPENFILEERRORBOX.

Requirements

  Windows NT/2000: Requires Windows NT 3.1 or later.
  Windows 95/98: Requires Windows 95 or later.
  Header: Declared in Winbase.h; include Windows.h.
  Library: Use Kernel32.lib.

See Also

File I/O Overview, File I/O Functions, _lwrite, ReadFile, SetErrorMode