arms_get_rs_url()

関数

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

呼び出し方向

アプリケーション->libarms

目的

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

説明

arms_pull() 実行時にRS から取得した、SA->RS方向の通信で使われる RSの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 が取得し保持している RS 情報のセット数(0 を含む)。 実際に書き込んだ数ではない点に注意すること。

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

可能

ヒストリ

このAPIはVer3.00で追加された。