IOaskQuestion

Top  Previous  Next

Question to user put and fetch answer.

With this function a question can be put to the user, and the answer to it becomes zurückgeliefert.

Parametre

root (PROOT) [IN]

Act on the open data bank.

Module name (const char *) [IN]

All issues stand in files. To organise the issues in groups, module names are used. These module names can be, e.g., the functional names of the user functions, or name for internal processes

msg_id (int) [IN]

Because in the respective groups several issues can stand, they are numbered, in addition. The text which becomes a module name with the figure msg_id augeführt in the group is given.

max_len (int) [IN]

With max_len it is given how much place exists for the answer. Because the answer is always delivered as a sign chain, a lot of storage space must also exist accordingly.

helpID (const char *) [IN]

Is not supported at the moment yet and can be, therefore, ZERO.

answer (char *) [IN / OUT]

The answer becomes in answer zurückgeliefert if the return value 1 is. If is the return value 0, stands in answer no valid answer.

... [IN]

With the ellipse it is to be handed over permissibly a variable number in arguments to the routine. Besides, the sign chain which is identified about module name and msg_id must have the right types in the right order in the text. The format in which the parametres are described is same like with the C routine printf.

Result

(int) [OUT]

Return values:

1: perfect implementation

0: no answer, it became only the <RETURN> - key low-spirited.

Declaration

#include "system.h"

 

int DLLENTRY IOaskQuestion (

PROOT root,

const char * module name,

int msg_id,

int max_len,

const char * helpID,

char * answer,

...

);

Related functions

IOyesNo

IOyesNoCancel