GetCsvReturnCode

La fonction GetCsvReturnCode 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 à l’aide de verbes de service courants (CSV).

Syntaxe

  
    int WINAPI GetCsvReturnCode(   
struct csv_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 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 une fois la fonction terminée.

Valeur de retour

La fonction GetCsvReturnCode retourne une valeur positive sur la réussite qui indique la longueur de la chaîne d’erreur passé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 paramètres de 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 CSV CSVST32.DLL.

Remarques

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

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