_UserError( ), API-Bibliotheksroutine

Gibt eine Fehlermeldung mit dem in der Meldung message angegebenen Text aus. Der Text muss ein mit Nullzeichen abgeschlossener Text sein.

void _UserError(char FAR *message)
char FAR *message;         /* Error message. */

Hinweise

Visual FoxPro gibt als internen Code für diesen Fehler den Wert 98 zurück. Der von der Visual FoxPro-Funktion ERROR( ) zurückgegebene Code ist 1098. Die Visual FoxPro-Funktion MESSAGE( ) zeigt den Benutzern die angegebene message an. Die Steuerung wird nicht zurückgegeben, sondern an die Fehlerbehandlungsroutine von Visual FoxPro übergeben.

Anmerkung   Rufen Sie _UserError( ) nicht in einer CALLUNLOAD-Routine auf: Die Bibliothek wird aufgrund des _UserError( )-Aufrufes nicht geladen, und es wird keine Fehlermeldung angezeigt.

Weitere Informationen zum Erstellen einer API-Bibliothek und ihrer Integration in Visual FoxPro finden Sie unter Zugreifen auf die Visual FoxPro-API.

Beispiel

Im folgenden Beispiel wird _UserError( ) aufgerufen, um zu zeigen, dass die Ausführung nach _UserError( ) nicht an die API-Routine zurückgegeben wird.

Visual FoxPro-Code

SET LIBRARY TO EXAMPLE
= EXAMPLE()

C-Code

#include <pro_ext.h>

FAR UserErrorEx(ParamBlk FAR *parm)
{
   _UserError("This is a _UserError() example.");
   _PutStr("This should never be displayed.");
}

FoxInfo myFoxInfo[] = {
   {"EXAMPLE", (FPFI) UserErrorEx, 0, ""},
};
FoxTable _FoxTable = {
   (FoxTable FAR *) 0, sizeof(myFoxInfo)/sizeof(FoxInfo), myFoxInfo
};

Siehe auch

_Error( ), API-Bibliotheksroutine | _ErrorInfo( ), API-Bibliotheksroutine | ERROR( )-Funktion | MESSAGE( )-Funktion | Zugreifen auf die Visual FoxPro-API