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 writes data to a file. CeWriteFilestarts writing data to the file at the position indicated by the file pointer. After the write operation has been completed, the file pointer is adjusted by the number of bytes actually written.
CeWriteFileis 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 CeWriteFile( HANDLE hFile , LPCVOID lpBuffer , DWORD nNumberOfBytesToWrite , LPDWORD lpNumberOfBytesWritten , LPOVERLAPPED lpOverlapped );
Parameters
A value of zero specifies a null write operation. A null write operation does not write any bytes but does cause the time stamp to change. CeWriteFiledoes not truncate or extend the file. To truncate or extend a file, use the CeSetEndOfFilefunction.
Named pipe write operations across a network are limited to 65,535 bytes.
Return Values
Nonzero indicates success. Zero indicates failure. To get extended error information, call CeGetLastError.
Remarks
If part of the file is locked by another process and the write operation overlaps the locked portion, this function fails.
Accessing the output buffer while a write operation is using the buffer may lead to corruption of the data written from that buffer. Applications must not read from, write to, reallocate, or free the output buffer that a write operation is using until the write operation completes.
Requirements
Runs On | Versions | Defined in | Include | Link to |
---|---|---|---|---|
Windows CE OS | 2.0 and later | Rapi.h |
See Also
WriteFile, CeCreateFile, CeGetLastError, CeReadFile, CeSetEndOfFile