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

17.4.2.3 ポップアップメッセージ送信(ドメイン)API

ポップアップメッセージ送信(ドメイン)API(Mp_PopupDomain)について説明します。

■記述形式

long Mp_PopupDomain (unsigned char *AppName,
　　　　　　　　　　　　char *domain,
　　　　　　　　　　　　unsigned char *MsgText)

■機能説明

指定されたドメインに接続しているすべてのコンピュータにポップアップメッセージを表示します。

■パラメタの説明

◆AppName

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

◆domain

メッセージを表示するドメイン名のアドレスを指定します。ドメイン名は15バイト以内で指定します。

◆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" ;   // 依頼元アプリケーション名
char *domain           = "Domain" ;            // 送信先のドメイン名
unsigned char *text    = "システムを停止します。" ; // 送信するメッセージテキスト
long lrc ;

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

/* 正常終了 */