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 utilisant des verbes de service communs (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 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 de la mémoire tampon qui contiendra la chaîne mise en forme terminée par null lorsque la fonction se termine.

Valeur renvoyée

La fonction GetCsvReturnCode retourne une valeur positive en cas de réussite qui indique la longueur de la chaîne d’erreur passée dans buffer_addr.

Une valeur de retour égale à 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
Le tampon spécifié est trop petit.

0x20000003
Impossible de charger la bibliothèque de chaînes CSV CSVST32.DLL.

Notes

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

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