GetAppcReturnCode 函数将谓词控制块中的主返回代码和辅助返回代码转换为可打印字符串。 此函数提供一组标准错误字符串,供 APPC 应用程序(如 5250 模拟器)使用。
Syntax
int WINAPI GetAppcReturnCode(
struct appc_hdr FAR * vpb,
UINTbuffer_length,
unsigned char FAR * buffer_addr);
参数
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中,可以针对不同语言进行自定义。