WINERROR

Löst den FoxPro Fehler 1098 aus und verwendet als Fehlermeldung den vom Betriebssystem vorgegebenen Meldungstext.

WINERROR( nWinError )

Rückgabewert

Nicht definiert

Parameter

nWinError

Viele Windows API Funktionen setzen beim Auftreten eines Fehlers einen Fehlerwert, der mit GetLastError() abgefragt werden kann. Übergeben Sie dieser Funktion den Wert, den GetLastError() zurückgibt. Andere Windows API Funktionen wie z.B. RegOpenKey() geben den Fehlerwert unmittelbar zurück.

Beispiele

WINERROR(0)          && Der Vorgang wurde erfolgreich beendet.
WINERROR(87)         && Falscher Parameter.
WINERROR(0x80004005) && Unbekannter Fehler. (E_FAIL)

Anmerkungen

• Diese Funktion versucht, vom Betriebssystem einen Meldungstext zum angegebenen Fehler zu bekommen. Dabei wird insbesondere in mehrsprachigen Windows Versionen wie folgt vorgegangen:
  1. Sprachneutraler Meldungstext,
  2. Meldungstext in der Sprache, unter der der Thread läuft,
  3. Meldungstext in der Sprache, die der Benutzer als Standard gewählt hat,
  4. Meldungstext in der Standard-Sprache des Betriebssystems,
  5. Englischer Meldungstext (USA),
  6. Meldungstext in irgend einer verfügbaren Sprache,
  7. Meldung System Error nnn (0xhhhhhhhh).
• Um die Windows API Funktion aufrufen zu können, muss sie zuvor in FoxPro wie folgt deklariert werden:

  DECLARE Integer GetLastError IN WIN32API
  

• Einige wenige Fehlermeldungen des Betriebssystem können nicht ausgewertet werden, weil sich die Meldungstexte in Modulen befinden, die nicht unmittelbar Teil des Betriebssystems sind, z.B. wininet.dll.
• Da die Funktion einen FoxPro Fehler auslöst und damit keinen Rückgabewert hat, sollten Sie niemals versuchen, das Ergebnis dieser Funktion auszuwerten oder zu speichern, da der Rückgabewert explizit Nicht definiert ist. Gegebenenfalls kann sich diese Spezifikation in einer späteren Version durch die Deklaration zusätzlicher Parameter ändern und diese Funktion anstelle einen FoxPro Fehler auszulösen einen Wert zurückgeben.

Siehe auch