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

4.6 Mp_CloseMsg（）関数

機能説明

メッセージの受信を終了する場合には、必ずMp_CloseMsg（）関数を発行します。

呼び出し形式

【Windows版】

#include <mp_opagt_api.h>
int Mp_CloseMsg( fp );

HANDLE fp;    /*  Mp_OpenMsg()で獲得したハンドルを指定する  */

【UNIX版】

#include <mp_opagt_api.h>
int Mp_CloseMsg( fp );

int fp;    /*  Mp_OpenMsg()で獲得したファイル識別子を指定する*/

パラメタ

fp:

Mp_OpenMsg（）で獲得したハンドル、またはファイル識別子を指定します。

実行に必要な権限/実行環境

【Windows版】

• 運用管理サーバ/部門管理サーバ/業務サーバでは、Administrator権限/DmAdmin権限/DmOperation権限/DmReference権限が必要です。

• 運用管理クライアント/クライアントでは、一般ユーザ権限で実行可能です。

• 運用管理サーバ/部門管理サーバ/業務サーバで実行可能です。

• 運用管理クライアント/クライアントでは、[イベント監視]を選択インストールしたとき実行可能です。

【UNIX版】

• 運用管理サーバ/部門管理サーバ/業務サーバではシステム管理者(スーパーユーザ)権限が必要です。

• 運用管理クライアント/クライアントでは、一般ユーザ権限で実行可能です。

• 運用管理サーバ/部門管理サーバ/業務サーバで実行可能です。

• 運用管理クライアント/クライアントでは、[イベント監視]を選択インストールしたとき実行可能です。

参照

以下のシステム監視のAPIを参照してください。

• Mp_OpenMsg（）関数

• Mp_GetMsgMap（）関数【Windows版】

• Mp_ReadMsg（）関数

復帰値

0:

正常終了。

-1:

異常終了。

備考

マイナス復帰した場合の詳細なエラーコードは、以下の方法で取得/参照してください。

【Windows版】

GetLastError（）で取得してください。

【UNIX版】

エラーコードは、errnoに設定されます。
errnoには、システムのエラーコード（/usr/include/sys/errno.hに定義）、または/opt/systemwalker/include/mp_operr_api.hに定義されている値が設定されます。

API格納場所

“監視メッセージのAPI”を参照してください。

動作環境による差異

以下のインストール種別で使用可能です。

• 運用管理サーバ

• 部門管理サーバ

• 業務サーバ

• 運用管理クライアント:
  Windows(R) 2000/Windows NT(R)/Windows(R) XP(注)/Windows Vista(R)/Windows(R) 7

• クライアント:
  Windows(R) 2000/Windows NT(R)/Windows(R) XP(注)/Windows Vista(R)/Windows(R) 7

  注)システム監視エージェントインストール選択時