GetAppcReturnCode

Die GetAppcReturnCode-Funktion konvertiert die primären und sekundären Rückgabecodes im Verb-Steuerelementblock in eine druckbare Zeichenfolge. Diese Funktion stellt einen Standardsatz von Fehlerzeichenfolgen für die Verwendung von APPC-Anwendungen wie 5250 Emulatoren bereit.

Syntax

  
    int WINAPI GetAppcReturnCode(   
struct appc_hdr FAR * vpb,  
UINTbuffer_length,  
unsigned char FAR * buffer_addr);  

Parameter

Vpb
Angegebener Parameter. Gibt die Adresse des Verb-Steuerelementblocks an.

buffer_length
Angegebener Parameter. Gibt die Länge des Puffers an, auf die buffer_addr zeigt. Die empfohlene Länge beträgt 256.

buffer_addr
Angegebener Parameter. Gibt die Adresse des Puffers an, der die formatierte, mit Null beendete Zeichenfolge enthält.

Rückgabewert

Die GetAppcReturnCode-Funktion gibt einen positiven Wert für den Erfolg zurück, der die Länge der in buffer_addr zurückgegebenen Fehlerzeichenfolge angibt.

Ein Rückgabewert von Null gibt einen Fehler an. Unter Microsoft Windows stellt ein Aufruf von GetLastError den tatsächlichen Fehlerrücklaufcode wie folgt bereit:

0x20000001
Die Parameter sind ungültig; die Funktion konnte nicht aus dem angegebenen Verb-Steuerelementblock gelesen werden oder konnte nicht in den angegebenen Puffer schreiben.

0x20000002
Der angegebene Puffer ist zu klein.

0x20000003
Die APPC-Zeichenfolgenbibliothek APPCST32.DLL konnte nicht geladen werden.

Bemerkungen

Die in buffer_addr zurückgegebene beschreibende Fehlerzeichenfolge wird nicht mit einem neuen Zeilenzeichen (\n) beendet.

Die beschreibenden Fehlerzeichenfolgen sind in APPCST32.DLL enthalten und können für verschiedene Sprachen angepasst werden.