Systemwalker Centric Manager API・スクリプトガイド

4.17 Mp_GetNodeIFTraffic（）関数

機能説明

指定したノードのインタフェースのトラフィック情報を獲得します。

呼び出し形式

int Mp_GetNodeIFTraffic( char *lpNode, unsigned long dwIfIndex,
                         LPMP_TRFIF_INF lpMpTrfIfInf ) ;

パラメタ

lpNode:

ノード名を表す文字列へのポインタ。

dwIfIndex:

インタフェース番号。
そのノードが持つ、インタフェースの番号を1以上で指定します。

lpMpTrfIfInf:

インタフェース別トラフィック情報格納構造体へのポインタ。
呼び出し側で用意した構造体の先頭ポインタを渡します。

復帰値

0:

正常終了。

-1:

異常終了。
詳細なエラーコードは、errnoを参照してください。
通知されるエラーコードは以下のとおりです。

F3CRTINF_WARN_DEFFECTIVE:

関数の引数が不当です。

F3CRTINF_ERROR_INSUFFCIENT_BUFFER:

領域不足が発生しました。

F3CRTINF_ERROR_ENVIRONMENT:

動作環境が不当です。

F3CRTINF_ERROR_INERROR:

内部エラーが発生しました。

F3CRTINF_ERROR_CONFIGURATION:

構成情報の取得に失敗しました。

F3CRTINF_ERROR_COMMUNICATION:

性能監視エージェントとの通信に失敗しました。

F3CRTINF_ERROR_HISTORY:

性能監視エージェントで異常が発生しました。

備考

• Mp_GetNodeIFTraffic（）関数は、指定したノードが持つ、インタフェースの最新のトラフィック情報を獲得し、呼び出し側で用意したMP_TRFIF_INF構造体に代入します。

• dwIfIndexでは、必ず1以上の値を設定してください。
  なお、指定した番号のインタフェースが存在しない場合は、-1を返します。

• トラフィック情報が獲得できなかった場合は、MP_TRFIF_INF内の該当するフィールドにMP_TRF_INF_INGが設定されます。