Hitachi

JP1 Version 12 JP1/Base 関数リファレンス


JevGetExtAttrDirect

〈このページの構成〉

機能

JP1イベントの拡張属性を取得します。

定義ヘッダー

JevApi.h

形式

const char*JevGetExtAttrDirect(long* lplStatus,
                               JP1EVENT event,
                               const char* lpszName);

引数

lplStatus

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

表3‒12 状態コードと意味(JevGetExtAttrDirect)

状態コード

意味

JEV_S_PARAM_ERROR

パラメーターが不正です。

JEV_S_NOT_DEFINED

指定した属性は未登録です。

event

JP1イベントアクセス用ハンドル(JevGetEvent()関数の戻り値)を指定します。

lpszName

拡張属性名を指定する文字列へのポインターを指定します。

戻り値

正常終了

指定されたハンドルで参照できるJP1イベントの拡張属性値を返す。

異常終了

NULLポインターを返す。また,失敗時の詳細エラーコードをlplStatusで指定された領域に格納する。