JevGetDestinationAddress
機能
JP1イベントの基本属性(送信先IPアドレス)を取得します。
定義ヘッダー
JevApi.h
形式
int JevGetDestinationAddress(long* lplStatus, JP1EVENT event, int* lpnSize, const char** const lppszValue);
引数
lplStatus
この関数の異常終了時の状態コードを返す領域へのポインターを指定します。状態コードとその意味は次のとおりです。
状態コード |
意味 |
---|---|
JEV_S_PARAM_ERROR |
パラメーターが不正です。 |
event
JP1イベントアクセス用ハンドル(JevGetEvent()関数の戻り値)を指定します。
lpnSize
送信先IPアドレス長を格納する領域へのポインターを指定します。なお,IPv6環境で取得したJP1イベントの送信先IPアドレス長は,16になります。
lppszValue
取得した送信先IPアドレスへのポインターを保存するための領域を示すポインターを指定します。
戻り値
正常終了 |
0を返し,送信先IPアドレスへのポインターをlppszValueで指定された領域に格納する。また,送信先IPアドレス長をlpnSizeで指定された領域に格納する。 |
異常終了 |
-1を返す。また,失敗時の詳細エラーコードをlplStatusで指定された領域に格納する。 |