Share via


CeDeleteFile

This function deletes an existing file from the object store. CeDeleteFile is a RAPI that enables an application that is running on a desktop computer to make function calls on a Microsoft® Windows® CE–based device.

STDAPI_(BOOL) CeDeleteFile(
  LPCWSTR lpFileName 
);

Parameters

  • lpFileName
    [in] Long pointer to a null-terminated string that specifies the file to be deleted.

Return Values

Nonzero indicates success. Zero indicates failure. To determine whether a function failed because of RAPI errors, call CeRapiGetError. To determine whether a function failed because of non-RAPI errors, call CeGetLastError.

Remarks

If an application attempts to delete a file that does not exist, the CeDeleteFile function fails. The CeDeleteFile function fails if an application attempts to delete a file that is open for normal I/O or as a memory-mapped file.

Use the CeRemoveDirectory function to delete a directory.

To close an open file handle, use the CeCloseHandle function.

To disconnect a database volume, use the CeUnmountDBVol function.

Requirements

Pocket PC Platforms: Pocket PC 2000 and later
OS Versions: Windows CE 3.0 and later
Header: rapi.h
Library: rapi.lib

Send feedback on this topic to the authors.

© 2005 Microsoft Corporation. All rights reserved.