CeMoveFile (RAPI) (Windows CE 5.0)
This function renames an existing file or a directory — including all of its children.
CeMoveFile is a remote application programming interface (RAPI), that enables an application running on a desktop computer to make function calls on a Windows CE–based device.
BOOLCeMoveFile(LPCWSTRlpExistingFileName, LPCWSTRlpNewFileName);
Parameters
- lpExistingFileName
[in] Long pointer to a null-terminated string that names an existing file or directory. - lpNewFileName
[in] Long pointer to a null-terminated string that specifies the new name of a file or directory. The new name must not already exist. A new file may be on a different file system or drive. A new directory must be on the same drive. Note that the concept of a current directory does not exist in Windows CE. You must specify the complete directory path.
Return Values
Nonzero indicates success. Zero indicates failure. To determine if a function failed because of RAPI errors, call CeRapiGetError. To determine if a function failed because of non-RAPI errors, call CeGetLastError.
Remarks
CeMoveFile cannot move a directory if the destination is on a different volume.
When writing applications for Windows CE 1.0 and 1.01, use the PegMoveFile function.
Requirements
OS Versions: Windows CE 2.0 and later.
Header: Rapi.h.
Link Library: Rapi.lib.
See Also
RAPI Functions | CeGetLastError | CeRapiGetError | MoveFile
Send Feedback on this topic to the authors