Systemwalker Centric Manager API・スクリプトガイド - UNIX/Windows(R)共通 -

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が設定されます。