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 que las usen las 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 de verbo.

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

buffer_addr
Parámetro proporcionado. Especifica la dirección del búfer que va a contener la cadena con formato terminada en un valor NULL.

Valor devuelto

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

Un valor devuelto de cero indica un error. En Microsoft Windows, una llamada a GetLastError proporciona el código de retorno de error real de la siguiente manera:

0x20000001
Los parámetros no son válidos. La función no pudo leer el 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.

Comentarios

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 distintos idiomas.