GetAppcReturnCode

La fonction GetAppcReturnCode convertit les codes de retour principal et secondaire dans le bloc de contrôle verbe en chaîne imprimable. Cette fonction fournit un ensemble standard de chaînes d’erreur à utiliser par les applications APPC telles que 5250 émulateurs.

Syntaxe

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

Paramètres

vpb
Paramètre fourni. Spécifie l’adresse du bloc de contrôle de verbe.

buffer_length
Paramètre fourni. Spécifie la longueur de la mémoire tampon pointée par buffer_addr. La longueur recommandée est 256.

buffer_addr
Paramètre fourni. Spécifie l’adresse de la mémoire tampon qui contiendra la chaîne mise en forme et terminée par null.

Valeur de retour

La fonction GetAppcReturnCode retourne une valeur positive en cas de succès qui indique la longueur de la chaîne d’erreur renvoyée dans buffer_addr.

Une valeur de retour de zéro indique une erreur. Sur Microsoft Windows, un appel à GetLastError fournit le code de retour d’erreur réel comme suit :

0x20000001
Les paramètres ne sont pas valides ; la fonction n’a pas pu lire à partir du bloc de contrôle verbe spécifié ou n’a pas pu écrire dans la mémoire tampon spécifiée.

0x20000002
La mémoire tampon spécifiée est trop petite.

0x20000003
Impossible de charger la bibliothèque de chaînes APPC APPCST32.DLL.

Remarques

La chaîne d’erreur descriptive retournée dans buffer_addr ne se termine pas par un nouveau caractère de ligne (\n).

Les chaînes d’erreur descriptives sont contenues dans APPCST32.DLL et peuvent être personnalisées pour différentes langues.