다음을 통해 공유


CeMoveFile (RAPI) (Windows CE 5.0)

Send Feedback

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

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.