arms_get_rs_tunnel_url()

関数

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

呼び出し方向

アプリケーション->libarms

目的

SSLトンネルの情報を取得する。(SA->RS方向)

説明

arms_push_method_query() により RS との間で通信方式について 情報交換を行った際に受信した、SSL トンネル接続に用いる 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 が取得し保持しているトンネル情報のセット数(0 を含む)。 実際に書き込んだ数ではない点に注意すること。

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

可能

ヒストリ

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