CeCopyFile (RAPI)

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function copies an existing file on a remote Windows Embedded CEā€“based device to a new file on the remote device.

Syntax

BOOL CeCopyFile(
  LPCWSTR lpExistingFileName, 
  LPCWSTR lpNewFileName, 
  BOOL bFailIfExists 
);

Parameters

  • lpExistingFileName
    [in] Long pointer to a null-terminated string that specifies the name of an existing file.
  • lpNewFileName
    [in] Long pointer to a null-terminated string that specifies the name of the new file.
  • bFailIfExists
    [in] Boolean value that specifies how this operation is to proceed if a file of the same name as that indicated by lpNewFileName already exists. If bFailIfExists is TRUE and the new file already exists, the function fails. If bFailIfExists is FALSE and the new file already exists, the function overwrites the existing file and succeeds.

Return Value

Nonzero indicates success. Zero indicates failure. To get extended error information, call CeGetLastError and CeRapiGetError.

Requirements

Header rapi.h
Library rapi.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2000 and later, Smartphone 2002 and later

See Also

Reference

RAPI Functions