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で指定された領域に格納する。 |