IOaskQuestion |
Top Previous Next |
|
Frage an Benutzer stellen und Antwort abholen. Mit dieser Funktion kann dem Benutzer eine Frage gestellt werden, und die Antwort darauf wird zurückgeliefert. Parameter root (PROOT) [IN] Handle auf die geöffnete Datenbank. ModuleName (const char *) [IN] Alle Ausgaben stehen in Dateien. Um die Ausgaben in Gruppen zu organisieren, werden Modulnamen verwendet. Diese Modulnamen können z.B. die Funktionsnamen der Benutzerfunktionen sein, oder Namen für interne Vorgänge msg_id (int) [IN] Da in den jeweiligen Gruppen mehrere Ausgaben stehen können, werden sie zusätzlich nummeriert. Der Text, der in der Gruppe ModuleName mit der Ziffer msg_id augeführt wird, wird ausgegeben. max_len (int) [IN] Mit max_len wird angegeben, wieviel Platz für die Antwort vorhanden ist. Da die Antwort immer als Zeichenkette geliefert wird, muss dementsprechend auch viel Speicherplatz vorhanden sein. helpID (const char *) [IN] Wird im Moment noch nicht unterstützt und kann deshalb NULL sein. answer (char *) [IN/OUT] Die Antwort wird in answer zurückgeliefert, wenn der Rückgabewert 1 ist. Ist der Rückgabewert 0, steht in answer keine gültige Antwort. ... [IN] Mit der Ellipse ist es erlaubt eine variable Anzahl an Argumenten an die Routine zu übergeben. Die Zeichenkette, die über ModulName und msg_id identifiziert wird, muss dabei im Text die richtigen Typen in der richtigen Reihenfolge haben. Das Format, in dem die Parameter beschrieben werden, ist das gleiche wie bei der C-Routine printf. Ergebnis (int) [OUT] Rückgabewerte: 1 : fehlerfreie Ausführung 0 : keine Antwort, es wurde nur die <RETURN> - Taste gedrückt. Deklaration #include "system.h"
int DLLENTRY IOaskQuestion ( PROOT root, const char * ModuleName, int msg_id, int max_len, const char * helpID, char * answer, ... ); Verwandte Funktionen
|