PalmLsnCheckConfigDB function

Reports errors in a Palm Listener configuration database.

Prototype
palm_lsn_ret PalmLsnCheckConfigDB(
 Char const *  cfg,
 UInt16 * const rec
)
Parameters
  • 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 value

Return codes defined in the palm_lsn_ret enumeration.

See palm_lsn_ret enumeration.

Remarks

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

See also
Example

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
}