CeReadFile (RAPI)

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

This function reads data from a file, starting at the position indicated by the file pointer. After the read operation has been completed, the file pointer is adjusted by the number of bytes actually read.

CeReadFileis a remote application interface (RAPI), which enables an application running on a desktop computer to make function calls on a Windows CE–based device.

BOOL
CeReadFile(
HANDLE
hFile
,
LPVOID
lpBuffer
,
DWORD
nNumberOfBytesToRead
,
LPDWORD
lpNumberOfBytesRead
,
LPOVERLAPPED
lpOverlapped
);

Parameters

hFile

[in] Handle to the file to be read. The file handle must have been created with GENERIC_READ access to the file. This parameter cannot be a socket handle.

lpBuffer

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

nNumberOfBytesToRead

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

lpNumberOfBytesRead

[out] Pointer to the number of bytes read. CeReadFilesets this value to zero before doing any work or error checking.

lpOverlapped

[in] Unsupported; set to NULL.

Return Values

The CeReadFilefunction returns when one of the following is true: the number of bytes requested has been read or an error occurs.

Nonzero indicates success. If the return value is nonzero and the number of bytes read is zero, the file pointer was beyond the current end of the file at the time of the read operation. Zero indicates failure. To get extended error information, call CeGetLastError.

Remarks

If part of the file is locked by another process and the read operation overlaps the locked portion, this function fails.

Accessing the input buffer while a read operation is using the buffer may lead to corruption of the data read into that buffer. Applications must not read from, write to, reallocate, or free the input buffer that a read operation is using until the read operation completes.

The ReadFilefunction may fail and return ERROR_INVALID_USER_BUFFER or ERROR_NOT_ENOUGH_MEMORY whenever there are too many outstanding asynchronous I/O requests.

When a synchronous read operation reaches the end of a file, ReadFilereturns TRUE and sets * lpNumberOfBytesReadto zero. Windows CE does not support asynchronous read operations on files.

Requirements

Runs On	Versions	Defined in	Include	Link to
Windows CE OS	2.0 and later	Rapi.h