将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
特殊项目
EasyLoadErrorMessage()用于调用WinGP API中的函数,并且当该函数返回错误代码时,会将代码转换成一条消息。
WinGP SDK只为每个句柄记住一组错误状态信息。因此,在API中发生错误后,请立即调用EasyLoadErrorMessage()。请不要调用其他API函数,否则API就会覆盖错误状态信息, EasyLoadErrorMessage()将不能返回所需的错误状态。