GetCsvReturnCode

Die GetCsvReturnCode-Funktion konvertiert die primären und sekundären Rückgabecodes im Verb-Steuerelementblock in eine druckbare Zeichenfolge. Diese Funktion stellt einen Standardsatz von Fehlerzeichenfolgen für die Verwendung durch Anwendungen mit allgemeinen Dienstverben (CSVs) bereit.

Syntax

  
    int WINAPI GetCsvReturnCode(   
struct csv_hdr FAR * vpb,  
UINTbuffer_length,  
unsigned char FAR * buffer_addr);  

Parameter

Vpb
Angegebener Parameter. Gibt die Adresse des Verb-Steuerelementblocks an.

buffer_length
Angegebener Parameter. Gibt die Länge des Puffers an, auf den buffer_addr verweist. Die empfohlene Länge beträgt 256.

buffer_addr
Angegebener Parameter. Gibt die Adresse des Puffers an, der die formatierte, mit Null beendete Zeichenfolge enthält, wenn die Funktion abgeschlossen ist.

Rückgabewert

Die GetCsvReturnCode-Funktion gibt einen positiven Wert für den Erfolg zurück, der die Länge der in buffer_addr übergebenen Fehlerzeichenfolge angibt.

Ein Rückgabewert von Null gibt einen Fehler an. Unter Microsoft Windows stellt ein Aufruf von GetLastError den tatsächlichen Fehlerrücklaufcode wie folgt bereit:

0x20000001
Die Parameter sind ungültig; die Funktion konnte nicht aus dem angegebenen Verbparameterblock gelesen werden oder konnte nicht in den angegebenen Puffer schreiben.

0x20000002
Der angegebene Puffer ist zu klein.

0x20000003
Die CSV-Zeichenfolgenbibliothek CSVST32.DLL konnte nicht geladen werden.

Bemerkungen

Die in buffer_addr zurückgegebene beschreibende Fehlerzeichenfolge wird nicht mit einem Zeilenumbruchzeichen (\n) beendet.

Die beschreibenden Fehlerzeichenfolgen sind in CSVST32.DLL enthalten und können für verschiedene Sprachen angepasst werden.