GetAppcReturnCode

La funzione GetAppcReturnCode converte i codici restituiti primari e secondari nel blocco di controllo verbo in una stringa stampabile. Questa funzione fornisce un set standard di stringhe di errore per l'uso da parte di applicazioni APPC, ad esempio 5250 emulatori.

Sintassi

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

Parametri

Vpb
Parametro fornito. Specifica l'indirizzo del blocco di controllo verbo.

buffer_length
Parametro fornito. Specifica la lunghezza del buffer a cui punta buffer_addr. La lunghezza consigliata è 256.

buffer_addr
Parametro fornito. Specifica l'indirizzo del buffer che conterrà la stringa con terminazione null formattata.

Valore restituito

La funzione GetAppcReturnCode restituisce un valore positivo sull'esito positivo che indica la lunghezza della stringa di errore passata in buffer_addr.

Un valore restituito pari a zero indica un errore. In Microsoft Windows una chiamata a GetLastError fornisce il codice restituito di errore effettivo come indicato di seguito:

0x20000001
I parametri non sono validi; la funzione non è riuscita a leggere dal blocco di controllo verbo specificato o non è stato possibile scrivere nel buffer specificato.

0x20000002
Il buffer specificato è troppo piccolo.

0x20000003
Impossibile caricare la libreria di stringhe APPC APPCST32.DLL.

Commenti

La stringa di errore descrittiva restituita in buffer_addr non termina con un nuovo carattere di riga (\n).

Le stringhe di errore descrittive sono contenute in APPCST32.DLL e possono essere personalizzate per lingue diverse.