GetAppcReturnCode

La fonction GetAppcReturnCode convertit les codes de retour primaire et secondaire du 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 les émulateurs 5250.

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 du tampon vers lequel pointe buffer_addr. La longueur recommandée est 256.

buffer_addr
Paramètre fourni. Spécifie l’adresse du tampon qui contiendra la chaîne mise en forme terminée par Null.

Valeur renvoyée

La fonction GetAppcReturnCode retourne une valeur positive sur success qui indique la longueur de la chaîne d’erreur transmise 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 dans le bloc de contrôle de verbe spécifié ou écrire dans le tampon spécifié.

0x20000002
Le tampon spécifié est trop petit.

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.