3.54 DM_QueryError

Mit Hilfe dieser Funktion kann die Anwendung den Fehlercode abfragen, den der letzte DM-Aufruf erzeugt hat. Der Dialog Manager gibt die Anzahl der Fehler und die Fehler zurück.

DM_UInt DML_default DM_EXPORT DM_QueryError
(
  DM_ErrorCode buffp[ ],
  DM_UInt bufflen,
  DM_Options options
)

Parameter

<-> DM_ErrorCode buffp[]

Dies ist ein Array von Fehlercodes. Es wird durch den Dialog Manager belegt, muss aber innerhalb der Anwendung allokiert sein. Wenn das Array nicht groß genug ist, entfallen die letzten Fehler. Um sicherzugehen, dass alle Fehlercodes, die im Dialog Manager gespeichert sind, an die Anwendung übergeben werden können, sollte das Feld die Größe von 32 haben.

-> DM_UInt bufflen

Dies ist die Länge eines Fehlercode-Arrays, der dem Dialog Manager übergeben wurde.

-> DM_Options options

Dieser Parameter wird zur Zeit noch nicht benutzt und muss daher mit 0 belegt sein.

Rückgabewert

Die Anzahl der gültigen Fehler im Array.

Beispiel

Zentrale Routine für Fehlerbehandlung

static void QueryError()

{

    DM_ErrorCode errorbuffer[32];

    /* buffer für die aufgetretenen Fehler */

    register int i;

    int errors;    /* Anzahl der Fehler */

 

    if ((errors = DM_QueryError(errorbuffer, 32, 0)))

    for (i = 0; i < errors; i++)

        DM_TraceMessage(DM_ErrMsgText(errorbuffer[i], 0), 0);

}