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

3.41 Mp_ReadEvent（）関数

◆機能説明

Mp_OpenEvent（）発行後、Mp_ReadEvent（）関数とMp_GetEventMap（）関数を組み合わせて発行することにより、監視イベントを1イベントずつ読み出します。

Mp_ReadEvent（）関数は、Systemwalker Centric Managerに対して、イベントの受信を要求してすぐに呼び出し元に戻ります。

◆呼び出し形式

#include <mp_opmgr_api.h>
BOOL   Mp_ReadEvent( fp, buf, rlen, olr );

HANDLE     fp;      /*  ハンドルを指定する                     */
char       *buf;    /*  データ格納領域のアドレスを指定する      */
DWORD      *rlen;   /*  読み取りバイト数格納領域のアドレスを指定*/
                    /*    する                               */
OVERLAPPED *olr;    /*  OVERLAPPED構造体のアドレスを指定する   */

◆パラメタ

fp:

Mp_OpenEvent（）で獲得したハンドルを指定します。

buf:

受信データを格納する領域アドレスを指定します。
MPOP_EVTDATAREADLENバイト分呼び出し元で準備します。

rlen:

実際に読み取ったバイト数を格納する領域のアドレスを指定します。

olr:

イベント受信の非同期I/Oで使用するOVERLAPPED構造体のアドレスを指定します。

◆参照

Mp_OpenEvent（）,Mp_CloseEvent（）,Mp_GetEventMap（）

◆復帰値

正常終了、異常終了:

ReadFile（）関数の復帰情報が、そのまま応答されます。
詳細なエラーコードは、GetLastError（）で取得してください。

◆API格納場所

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

◆注意事項

呼び出し元は、Mp_ReadEvent（）関数の第4パラメタの、OVERLAPPED構造体を利用して、イベント受信のオーバラップ処理を完了し、Mp_GetEventMap（）関数を呼び出してください。

◆動作環境による差異

運用管理サーバで使用可能です。