Verarbeitet eine Nachricht entsprechend dem Inhalt einer Konfigurationsdatenbank.

Syntax

palm_lsn_ret PalmLsnProcess(
    struct a_palm_msg * Nachr,
    Char const * KonfigPDBName,
    UInt16 * const ProblematischeRecNum,
    Boolean * Bearbeitet
)

Parameter

Rückgabe

In der Enumeration palm_lsn_ret festgelegte Rückgabecodes. Weitere Hinweise finden Sie unter palm_lsn_ret-Enumeration.

Bemerkungen

PalmLsnProcess legt die geeignete Aktion fest, die als Antwort auf eine eingehende Nachricht ausgeführt werden soll. Die Funktion vergleicht die Felder der Nachricht mit Filtern, die in einer Konfigurationsdatenbank gespeichert sind.

Weitere Hinweise zur Erstellung der Listener-Konfigurationsdatenbank finden Sie unter Dienstprogramm zur Listener-Konfiguration für Palm-Geräte.

Die Datensätze in der Konfigurationsdatenbank speichern Informationen über Nachrichtenfilter und die Aktionen, die sich aus einer akzeptierten Nachricht ergeben sollten.

Ein Konfigurationsdatensatz hat das folgende Format:

[subject=<Zeichenfolge>;] [content=<Zeichenfolge>;]
[message|message_start=<Zeichenfolge>;] [sender=<Zeichenfolge>;]
action=run <app name> [Argumente]

Argumente ist eine anwendungsabhängige Zeichenfolge, die Aktionsvariable enthalten kann.

Siehe auch

• Dienstprogramm zur Listener-Konfiguration für Palm-Geräte
• Message-Handler
• Listener-Aktionsbefehle für Windows
• PalmLsnCheckConfigDB-Methode
• Methoden zur Nachrichtenverarbeitung

Beispiel

Der folgende Programmauszug bearbeitet eine Nachricht. Das Beispiel weist die Nachrichtenstruktur zu, initialisiert Felder und verarbeitet die Nachricht mit PalmLsnProcess:

a_palm_msg * ulMsg;
Boolean * handled 
Char configDb[dmDBNameLength];
...

// Allocate the message structure
ulMsg = PalmLsnAllocate();
...

// Fill the message fields
ret = PalmLsnDupMessage(ulMsg, msgBody);
...

// Get the configuration database name
PalmLsnGetConfigFileName(configDb);

// Process the message
ret = PalmLsnProcess(ulMsg, configDb, NULL, handled);
...

// Free the message
PalmLsnFree(ulMsg);