JevGetClose

機能

イベントサーバから切断し,JevGetOpen()関数の戻り値で返されたJP1イベント取得用ハンドルを閉じます。

JevGetOpen()関数の戻り値で返されたJP1イベント取得用ハンドルは,必ずこの関数を使って閉じる必要があります(Windowsでは,この関数を呼び出さずにプロセスが終了してしまうとシステムリソースリークとなります)。

定義ヘッダー

JevApi.h

形式

int JevGetClose(long* lplStatus,
              JEVGETKEY key);

引数

lplStatus

この関数の異常終了時の状態コードを返す領域へのポインターを指定します。状態コードとその意味は次のとおりです。

表3-6 状態コードと意味(JevGetClose)

状態コード意味
JEV_S_CONNECT_ERRORイベントサービスに接続できません。
JEV_S_PARAM_ERRORパラメーターが不正です。
JEV_S_MAXOPENファイルオープン数が限界に達しました。
JEV_S_NOMEMORYメモリー不足です。
JEV_S_IO_ERR入出力エラーです。
JEV_S_SYSTEM_ERRORシステムエラーです(システムリソース不足です)。

key

JP1イベント取得用ハンドル(JevGetOpen()関数の戻り値)を指定します。

戻り値

正常終了0を返す。
異常終了-1を返す。また,失敗時の詳細エラーコードをlplStatusで指定された領域に格納する。