|
|
|
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’. |
||
|
Developer Home |