13.2.1 帳票印刷命令(汎用関数)
関数の形式とリターン情報について説明します。
- 〈この項の構成〉
(1) XmapDrvCreateOpen関数
ドライバを起動し,仮想端末をオープンします。一つのAP(プロセス)内で同時にオープンできる端末数の上限は15個です。
データ有無コードには標準値「1F」が仮定されます。
- 形式
long APIENTRY XmapDrvCreateOpen(tname) unsigned char *tname; /*仮想端末名*/
仮想端末名(tname):仮想端末名を指定します。仮想端末名(8バイト以下,9バイト以降は切り捨て)には,最後にNULLで終わる文字列を指定してください。
- リターンコード
-
1以上:正常終了(仮想端末識別子)
0:異常終了
(2) XmapDrvClose関数
仮想端末をクローズし,ドライバを解放します。
- 形式
long APIENTRY XmapDrvClose(termid) long termid; /*仮想端末識別子*/
仮想端末識別子(termid):オープン要求関数の戻り値を指定します。
- リターンコード
-
0:正常終了
−1:異常終了
(3) XmapDrvSend関数
帳票を出力します。
- 形式
long APIENTRY XmapDrvSend(termid,pmpname,olog); long termid; /* 仮想端末識別子 */ unsigned char *pmpname; /* 物理マップ名 */ unsigned char *olog; /* 出力論理マップ */
-
仮想端末識別子(termid):オープン要求関数の戻り値を指定します。
-
物理マップ名(pmpname):出力する物理マップ名を指定します。
-
出力論理マップ(olog):出力論理セグメントを指定します。
-
- リターンコード
-
0:正常終了
−1:異常終了
(4) XmapDrvGetError関数
直前に発行した関数のエラー詳細を取得します。
- 形式
long APIENTRY XmapDrvGetError( )
- リターンコード
-
0以上:正常終了(詳細エラーコード)
(6) XmapDrvOpen関数
仮想端末をオープンします。一つのAP(プロセス)内で同時にオープンできる端末数の上限は15個です。
- 形式
long APIENTRY XmapDrvOpen(termid,tname) long termid; /* 仮想端末識別子 */ unsigned char *tname; /* 仮想端末名 */
-
仮想端末識別子(termid):XmapDrvCreateの戻り値を指定します。
-
仮想端末名(tname):仮想端末定義ファイルで指定した名称を指定します。
-
- リターンコード
-
0:正常終了
−1:異常終了
(7) XmapDrvSetDataCode関数
データの有無コードを設定します。この関数を発行しない場合,データ有無コードには標準値「1F」が仮定されます。
- 形式
long APIENTRY XmapDrvSetDataCode(termid,code) long termid; /*仮想端末識別子*/ unsigned char code; /*データ有無コード*/
-
仮想端末識別子(termid):オープン要求関数の戻り値を指定します。
-
データ有無コード(code):データ有無コード((00)16〜(1F)16,または(FF)16)を設定します。データ有無コードは,すべてのAPにかかわるコードのため,できるだけ標準値((1F)16)を利用することをお勧めします。
-
- リターンコード
-
0:正常終了