GetAppcReturnCode

La función GetAppcReturnCode convierte los códigos de retorno principales y secundarios en el bloque de control de verbos en una cadena imprimible. Esta función proporciona un conjunto estándar de cadenas de error para su uso por parte de aplicaciones APPC como 5250 emuladores.

Sintaxis

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

Parámetros

vpb
Parámetro proporcionado. Especifica la dirección del bloque de control del verbo.

buffer_length
Parámetro proporcionado. Especifica la longitud del búfer al que apunta buffer_addr. La longitud recomendada es de 256.

buffer_addr
Parámetro proporcionado. Especifica la dirección del búfer que contendrá la cadena con formato terminada en NULL.

Valor devuelto

La función GetAppcReturnCode devuelve un valor positivo en el éxito que indica la longitud de la cadena de error que se ha devuelto en buffer_addr.

Un valor devuelto de cero indica un error. En Microsoft Windows, una llamada a GetLastError proporciona el código de devolución de error real como se indica a continuación:

0x20000001
Los parámetros no son válidos; la función no pudo leer del bloque de control de verbo especificado o no pudo escribir en el búfer especificado.

0x20000002
El búfer especificado es demasiado pequeño.

0x20000003
No se pudo cargar la biblioteca de cadenas de APPC APPCST32.DLL.

Observaciones

La cadena de error descriptiva devuelta en buffer_addr no finaliza con un nuevo carácter de línea (\n).

Las cadenas de error descriptivas se encuentran en APPCST32.DLL y se pueden personalizar para diferentes idiomas.