JevGetEvent

機能

JevGetOpen()関数で指定した条件に合致するJP1イベントを1件取得します。この関数を繰り返し呼び出すことによって,JevGetOpen()関数で指定したフィルターに合致するJP1イベントを,イベントDBに登録された順に取得できます。

定義ヘッダー

JevApi.h

形式

JP1EVENT JevGetEvent(long* lplStatus,
                    JEVGETKEY key,
                    JEVACCESSTYPE access);

引数

lplStatus

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

表3-11 状態コードと意味(JevGetEvent)

状態コード意味
JEV_S_CONNECT_ERRORイベントサービスに接続できません。
JEV_S_INVALID_SERVERイベントサーバ名が不正です。
JEV_S_PARAM_ERRORパラメーターが不正です。
JEV_S_NO_EVENTフィルターに一致するJP1イベントが存在しません。
JEV_S_MAXOPENファイルオープン数が限界に達しました。
JEV_S_NOMEMORYメモリー不足です。
JEV_S_IO_ERR入出力エラーです。

key

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

access

JP1イベントを取得するときに,該当するJP1イベントが存在しない場合の動作を指定するための値を指定します。値は,次に示すどちらかです。

JEVGET_WAIT
該当するJP1イベントが発生するまで制御を戻しません。
JEVGET_NOWAIT
該当するJP1イベントがなければ,すぐにエラーリターンします。

戻り値

正常終了JP1イベントアクセス用ハンドルを返す。
異常終了NULLポインターを返す。また,失敗時の詳細エラーコードをlplStatusで指定された領域に格納する。