Systemwalker Operation Manager リファレンスマニュアル - UNIX/Windows(R)共通 -

17.4.2.4 ポップアップメッセージ送信(全ユーザ)API

ポップアップメッセージ送信(全ユーザ)API(Mp_PopupSession)について説明します。

■記述形式

long Mp_PopupSession (unsigned char *AppName,
　　　　　　　　　　　　unsigned char *MsgText)

■機能説明

サーバに接続しているすべてのセッションにポップアップメッセージを送信します。

■パラメタの説明

◆AppName

呼び出し元のアプリケーション名のアドレスを指定します。アプリケーション名は64バイト以内で指定します。

◆MsgText

ポップアップに表示するメッセージのアドレスを指定します。メッセージは128バイト以内で指定します。

■復帰値

正常に要求を受け取った場合は、0以上の整数を返します。0未満の場合はエラーとなります。

MPACT_PARAMERR:

パラメタエラーです。

MPACT_NOMEMORY:

メモリ不足です。

MPACT_NOTMOVE:

アクション管理サーバが起動されていません。

MPACT_COMFAIL:

アクション管理サーバとの通信に失敗しました。

MPACT_SYSERR:

アクション管理サーバでエラーが発生しました。

MPACT_NOTDLL:

アクション要求用DLLがロードできません。

MPACT_EXCEPT:

不当な領域のアドレスが指定されました。

■注意事項

ポップアップメッセージは、Microsoftネットワークでのみ使用できます。

■プログラム例

ポップアップメッセージ送信(全ユーザ)APIのプログラム例を以下に示します。

 

#include "f3crhxac.h"

unsigned char *AppName = "ポップアップAPI" ;        // 依頼元アプリケーション名
unsigned char *text    = "システムを停止します。" ; // 送信するメッセージテキスト
long lrc ;

lrc = Mp_PopupSession(AppName,text) ;
if ( lrc < 0 ) {
    /* エラー処理 */
}

/* 正常終了 */