GetAppcReturnCode

GetAppcReturnCode 函数将谓词控制块中的主返回代码和辅助返回代码转换为可打印的字符串。 此函数提供一组标准的错误字符串供 APPC 应用程序使用,例如 5250 仿真器。

语法

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

parameters

vpb
提供的参数。 指定谓词控制块的地址。

buffer_length
提供的参数。 指定 buffer_addr 指向的缓冲区的长度。 建议长度为 256。

buffer_addr
提供的参数。 指定将会保存以 null 结尾的格式化字符串的缓冲区的地址。

返回值

GetAppcReturnCode 函数在成功时返回一个正值,该值指示buffer_addr传回的错误字符串的长度。

返回值零表示错误。 在 Microsoft Windows 上,调用 GetLastError 可提供实际的错误返回代码,如下所示:

0x20000001
参数无效;函数无法从指定的谓词控制块读取,或者无法写入到指定的缓冲区。

0x20000002
指定的缓冲区太小。

0x20000003
无法加载 APPC 字符串库 APPCST32.DLL。

注解

buffer_addr 中返回的描述性错误字符串不会以新行字符 (\n) 结尾。

描述性错误字符串包含在 APPCST32.DLL 中,可以针对不同的语言进行自定义。