Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

PalmLsnCheckConfigDB function

Reports errors in a Palm Listener configuration database.

palm_lsn_ret PalmLsnCheckConfigDB(
Char const * cfg,
UInt16 * const rec
)

• cfg  A character array containing the name of the configuration database. You can obtain the configuration database name using the PalmLsnGetConfigFileName function.

  See PalmLsnGetConfigFileName.

• rec  An output parameter identifying the index of a problematic or malformed record in the configuration database.

Return codes defined in the palm_lsn_ret enumeration.

See palm_lsn_ret enumeration.

You can use this function to detect errors opening a configuration database or reading its records.

• PalmLsnProcess function

The following example uses PalmLsnCheckConfigDB to detect problematic or malformed records in a configuration database.

Err ret;
UInt16 badRec;
Char configDb[ dmDBNameLength ];

// Get configuration database name
PalmLsnGetConfigFileName( configDb );

// check for errors in the configuration database
ret = PalmLsnCheckConfigDB(configDb, &badRec);
if(ret!=errNone)
{
  // handle error
}