TlpClose

PURPOSE

Close the library.

PROTOTYPE

Trap: Err TlpClose (UInt16 refNum, UInt16 *refs)

PARAMETERS

refs

OUT

number of references to this library

DESCRIPTION

Close the library (disconnect and free global data). The library indicates it is still used by other applications by setting refs to a non zero value. If ref is zero, then you should unload the library by calling SysLibRemove.

TlpClose returns a PalmOS error code if it fails to disconnect or free the global data. This is not expected to ever happen; if it does the library is left in a unknown state.

SEE ALSO

TlpOpen.

EXAMPLE

UInt16 refs; ... err = TlpClose (tlpRef, &refs); if (err) ... handle error ... if (refs == 0) SysLibRemove (tlpRef);