Systemwalker Centric Manager APIガイド - Microsoft(R) Windows NT(R)/Microsoft(R) Windows(R) 2000/Microsoft(R) Windows Server(TM) 2003 -

3.29 Mp_OpenMsg（）関数

■機能説明

Mp_OpenMsg（）関数を発行することにより、メッセージの通知を要求します。

■呼び出し形式

#include <mp_opagt_api.h>
HANDLE  Mp_OpenMsg(node,NodeID,DatabaseID,mode);

char  *node;        /* 読み出しメッセージのノード名を指定する*/
DWORD  NodeID;      /* リザーブ領域                          */
DWORD  DatabaseID;  /* リザーブ領域                          */
int    mode;        /* モードを指定する                      */

■パラメタ

node:

読み出すメッセージのノード名を128バイト以内で指定します。自システムで出力されたメッセージだけを要求する場合には、OWNNODEを指定してください。
自システムにメッセージを通知しているすべてのシステムで出力されたメッセージを要求する場合には、ALLNODEを指定してください。

mode:

メッセージを受信する際のモードを指定します。
必ず0を指定してください。

■参照

システム監視のAPI、Mp_ReadMsg（）関数、Mp_CloseMsg（）関数、Mp_GetMsgMap（）関数を参照してください。

■復帰値

−1以外:

正常終了。関数の復帰値はメッセージを読み出すためのハンドル（Mp_ReadMsg（）で使用）。

−1:

異常終了。

備考

マイナス復帰した場合の詳細なエラーコードは、GetLastError（）で取得してください。

■API格納場所

Systemwalkerインストールディレクトリ\mpwalker.dm\bin

■動作環境による差異

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

• 運用管理サーバ
• 部門管理サーバ
• 業務サーバ
• 運用管理クライアント:Windows(R) 2000/ Windows NT(R)/ Windows(R) XP(注)
• クライアント　　　　:Windows(R) 2000/ Windows NT(R)/ Windows(R) XP(注)

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