arms_get_ls_url()

関数

int arms_get_ls_url(arms_context_t *ctx, arms_url_t *urlp, int size)

呼び出し方向

アプリケーション->libarms

目的

アクセス対象のLS の情報を取得する。(SA->LS方向)

説明

Initial-Config から取得した、SA->LS方向の通信で使われる LSのIPアドレスおよびポート番号をURL形式で取得する。

引数

arms_context_t *ctx

内部ステートを保持するコンテキスト構造体ポインタ。 arms_init() により取得したポインタをそのまま指定する。

arms_url_t *urlp

アプリケーション側に領域を用意した、アドレス情報取得用バッファの 先頭アドレスを示すポインタ。size で指定したバイト数の書き込みが 可能となっていなければならない。詳細は arms_url_t を参照。

int size

urlp のバッファサイズ[bytes]

返り値

-1

パラメータが不適切のため情報取得に失敗。 urlp が NULL、あるいは size が sizeof(arms_url_t) 未満。

-1以外

libarms が取得し保持している LS 情報のセット数(0 を含む)。 実際に書き込んだ数ではない点に注意すること。

コールバック関数からの呼び出し

可能

ヒストリ

このAPIはVer5.30で追加された。