Known Bugs

This purpose of this section in the API Guide is to cover as much as possible the list of known bugs that exist in some Palm libraries.

Name of the API | Filename | Status
Description of the bug

NVFS | Palm OS 5.4.9 | Exists: Palm T|X
NVFS implementation on Palm OS 5.4.9 has a lot more stringent error-checking that would cause non-fatal alert to be displayed more frequently. Whenever possible, please use the Debug Simulator for your application testing, and do not ignore alerts/crashes that don’t occur on Release Simulator or production units. A few very important points to note: - Protect locked records in closed databases via DmDatabaseProtect(). Locked records will be purged from DBCache if the database is already closed in order to introduce more aggressive cache flushing. - Alarm procedures must be locked at all times when it is expected to be triggered. Please refer to the Developer Guide for more information on NVFS.

VFSDirCreate() | VFSMgr.h | Exists: Palm T|X
Calling VFSDirCreate() with non-existent higher-level directories returns vfsErrFileGeneric rather than vfsErrDirectoryNotFound.

VFSExportDatabaseToFile () | VFSMgr.h | Exists: Palm T|X
When VFSExportDatabaseToFile is given a NULL value for a path name, it returns an unexpected error. It only happens when file operation is done in the hidden volume, and should behave correctly on SD card volume.

VFSFileSetAttributes() | VFSMgr.h | Exists: Tungsten E2, Palm T|X, Palm Z22
In the case where a VFS file already has its attributes set to be read-only, resetting the attributes to be non read-only will not return an error code, but the read-only flag will still remain, thus causing error when the application is trying to write to the file.

ImageLibCameraExists() | ImageLib.h | Exists: Treo 650
Calling ImageLibCameraExists() in the applications running on Treo 650 will return ‘false’, indicating that the device has no camera built-in.

PalmPhotoFileLocation | palmOnePhotoCommon.h | Exists: Treo 650/Tungsten T5/E2
Specifying palmPhotoMemoryLocation in PalmPhotoFileLocation when creating a photo handle out of image buffer in the memory will cause palmPhotoLibErrParam. To work around this, please create a file stream instead for an intermediate placeholder.

MMPRO_ADD_MESSAGE_WITH_ATTACHMENT | PalmVMPlugin.h | Exists: Treo 650
Using this launch code to launching VersaMail to add new email programmatically from 3rd party applications is no longer supported in version 3.0 and above.

DmSyncDatabase() | PmPalmOSNVFS.h | Exists: Treo 650/Tungsten T5/E2
There is a bug in DmSyncDatabase() where it returns undocumented error codes. To work around this bug, please define the following in the application code: void* DmSyncDatabaseErrInA0 (DmOpenRef dbRef) SYS_TRAP(sysTrapDmSyncDatabase); #define DmSyncDatabase(dbRef) ( (Err) DmSyncDatabaseErrInA0(dbRef) )

VFSFileOpen() | VFSMgr.h | Exists: Tungsten T5/E2
On Tungsten T5 and E2, opening file with filename that contains an invalid character using VFSFileOpen() will return vfsErrFileNotExists instead of vfsErrBadName.

VFSGetDefaultDirectory() | VFSMgr.h | Exists: Tungsten T5/E2
Calling VFSGetDefaultDirectory() cannot get the default directory for certain file types such that ".plm" and ".tkm".

Launching Media application | - | Exists: Treo 650/Tungsten T5/E2
Specifying ‘true’ in the noAsk parameter of ExgLocalSocketInfoType when passing data (pictures and such) and launching the Media application will cause the device to freeze. To avoid this issue, please allow the user confirmation dialog to pop-up by setting noAsk to ‘false’.

Top | Developer Home © 2004-2005, Palm, Inc. All rights reserved. Generated on Wed Apr 13 02:06:17 2005 for Palm API Guide