38.9.4.8 错误代码字符串转换(附有状态信息)

将WinGP SDK中的不同API返回的错误代码转换成错误消息。

可能的话,返回附有状态信息的错误消息。

EasyLoadErrorMessage()总是返回同已定义错误代码一样的错误消息。EasyLoadErrorMessageEx()返回更多详细信息,如发生故障的通讯对象的名称以及故障发生时的状态等。根据故障的位置,即使是同一错误代码也可能返回不同的错误消息。

EasyLoadErrorMessageEx()、 EasyLoadErrorMessageExM()返回多字节字符串消息(ASCII)

EasyLoadErrorMessageEx()、 EasyLoadErrorMessageExM()返回字符串消息(UNICODE)

函数名称

BOOL WINAPI EasyLoadErrorMessageEx(INT iErrorCode,LPSTR osErrorMessage);

BOOL WINAPI EasyLoadErrorMessageExW(INT iErrorCode,LPWSTR owsErrorMessage);

参数

iErrorCode:(In)WinGP SDK函数返回的错误代码

osErrorMessage:(Out)指向保存已转换字符串(ASCII)的区域的指针(准备1024个字节或以上)

osErrorMessage:(Out)指向保存已转换字符串(UNICODE)的区域的指针(准备2048个字节或以上)

返回值(NULL)

成功操作:非零的任何值

转换字符串失败(例如,未使用的错误代码): 0

特殊项目