Documentation  |   Table of Contents   |  < Previous   |  Next >  

38    ExgMgr.h

Porting Applications to Palm OS® Cobalt

Exploring Palm OS®


NOTE: Early in the porting process you may want to #include ExgMgrCompatibility.h (after the #include for PalmOS.h). This header file defines a number of APIs and macros that allow applications calling certain deleted functions and functions with modified prototypes to compile and run. This compatibility header should not be counted on long-term, however, so later in the porting process you should remove the #include and fix any problems that result.

Deleted APIs ^TOP^

Table 38.1  Deleted types

Deleted API

Use instead

ExgSocketPtr

Modified APIs ^TOP^

Table 38.2  Modified functions 

Modified API

Description of change

status_t ExgAccept (ExgSocketPtr)

status_t ExgConnect (ExgSocketPtr)

status_t ExgDBRead (ExgDBReadProcPtr, ExgDBDeleteProcPtr, void *, DatabaseID *, Boolean *, Boolean)

status_t ExgDBWrite (ExgDBWriteProcPtr, void *, const char *, DatabaseID)

status_t ExgDisconnect (ExgSocketPtr, status_t)

status_t ExgGet (ExgSocketPtr)

status_t ExgPut (ExgSocketPtr)

uint32_t ExgReceive (ExgSocketPtr, void *, uint32_t, status_t *)

uint32_t ExgSend (ExgSocketPtr, const void *const, uint32_t, status_t *)

Table 38.3  Modified structures

Modified API

Description of change

ExgAskParamType

ExgCtlGetURLType

ExgDialogInfoType

ExgGoToType

ExgPreviewInfoType

ExgSocketType

Table 38.4  Modified application-defined functions

Modified API

Description of change

Boolean (*ExgDBDeleteProcPtr) (const char *, uint16_t, DatabaseID, void *)

Unchanged APIs ^TOP^

Table 38.5  Unchanged functions

ExgControl()

ExgDoDialog()

ExgGetDefaultApplication()

ExgGetRegisteredApplications()

ExgGetRegisteredTypes()

ExgGetTargetApplication()

ExgInit()

ExgNotifyGoto()

ExgNotifyPreview()

ExgNotifyReceive()

ExgNotifyReceiveV35()

ExgRegisterData()

ExgRegisterDatatype()

ExgRequest()

ExgSetDefaultApplication()

Table 38.6  Unchanged types

ExgAskParamPtr

ExgGoToPtr

Table 38.7  Unchanged #defines 

exgBeamPrefix

exgBeamScheme

exgDataPrefVersion

exgErr...

exgGet

exgGetPrefix

exgGetScheme

exgLibAPIVersion

exgLibCtlGetPreview

exgLibCtlGetTitle

exgLibCtlGetURL

exgLibCtlGetVersion

exgLibCtlSpecificOp

exgLocalPrefix

exgMaxDescriptionLength

exgMaxTitleLen

exgMaxTypeLength

exgMemError

exgNoAsk

exgPreviewDialog

exgPreviewDraw

exgPreviewFirstUser

exgPreviewLastUser

exgPreviewLongString

exgPreviewQuery

exgPreviewShortString

exgRegCreatorID

exgRegExtensionID

exgRegSchemeID

exgRegTypeID

exgSendBeamPrefix

exgSendPrefix

exgSendScheme

exgSeparatorChar

exgTitleBufferSize

exgUnwrap

Table 38.8  Unchanged enumerated types

ExgAskResultType

Table 38.9  Unchanged application-defined functions

ExgDBReadProcPtr()

ExgDBWriteProcPtr()