Groupmax Workflow - Library Extensionが提供する各API関数内でエラーが発生した場合,API関数はエラーリターンとなります。そのとき,エラー情報の詳細としてメッセージ区分,メッセージ番号,及び挿入語句を出力します。Groupmax Workflow - Library Extension及びWindows NT/2000版Groupmax Workflow Server - Library Extensionでは,メッセージ区分,メッセージ番号及び挿入語句を基にメッセージ本文を出力するDLLを提供していて,アプリケーションでエラー時の内容を出力できます。
表8-6 メッセージ本文を出力するDLL名称
製品名称 | 提供インポートライブラリ | DLL名称 | ヘッダファイル |
---|---|---|---|
Groupmax Workflow Client - Library Extension | wfmsg32.lib | wfmsg32.dll | bwfad.h |
Groupmax Workflow Server - Library Extension(Windows NT版) | wfsmsg.lib | wfsmsg.dll | bwfad.h |
エラー時のメッセージ取得方法を,Visual C++の例で説明します。
AWF_errno_t errlist;
char Msgld[256];
char MsgLvl[256];
char MsgArea[256];
rtn = HwfAdStartUp(..... ,&errlist,NULL); // 関数を発行
if(rtn == AWF_OK) { // 正常リターン ?
}
else{ //エラーリターン
rtn = msgDLL(errlist.sBMsgKbn,errlist.lBMsgNo,errlist.sBInsWord,
MsgId,MsgLvl,MsgArea);
MessageBox(...,MsgArea, ......); //エラーメッセージを出力
}
メッセージ取得API関数のリファレンスを次に説明します。
#include <bwfad.h>
long msgDLL(
char *MsgKbn /* メッセージ区分 (I) */
long Msgban /* メッセージ番号 (I) */
char *InWord /* 挿入語句 (I) */
char *MsgId /* メッセージID (O) */
char *MsgLvl /* メッセージレベル (O) */
char *MsgArea /* メッセージ本文 (O) */
)
メッセージ本文長が戻ります。