機能説明
アクション管理サーバに依頼したアクションを停止します。
呼び出し形式
long Mp_StopAction(unsigned char *AppName,long handle)
パラメタ
停止するアクションを要求した(アクション実行用のAPIに指定した)呼び出し元のアプリケーション名のアドレスを指定します。
停止するアクションの管理番号(アクション実行用のAPIの復帰値)を指定します。
参照
以下のアクション管理のAPIを参照してください。
復帰値
停止処理を行います。
指定されたアクションは存在しません(すでに終了しています)。
対処は不要です。
指定されたアクションは実行中のため、停止できません。
停止する権限がありません。
Administrator権限で実行してください。
パラメタエラーです。
パラメタに誤りがないかを確認してください。
メモリ不足です。
ページファイルのサイズを拡張するか、またはメモリを増設してください。
アクション管理サーバが起動されていません。
サービス「Systemwalker MpAosfB」が起動されていることを確認してください。
アクション管理サーバとの通信に失敗しました。
サービス「Systemwalker MpAosfB」、および「Systemwalker MpAosfX」が起動されていることを確認してください。
アクション管理サーバでエラーが発生しました。
イベントログ/syslogに出力されたメッセージを参照してエラーの原因を取り除いたあと、Systemwalker Centric Managerを再起動してください。再現する場合は、保守情報収集ツールを使用して[イベント監視]の資料を採取したあと、技術員に連絡してください。
アクション要求用DLLがロードできません。
アクション管理に必要なファイルf3crhxac.dllが、以下のフォルダにあるかどうかを確認してください。
Systemwalkerインストールディレクトリ\mpwalker\bin
ない場合は、Systemwalker Centric Managerを再インストールするか、または保守情報収集ツールを使用して[イベント監視]の資料を採取したあと、技術員に連絡してください。
不当な領域のアドレスが指定されました。
内部論理異常が発生しています。保守情報収集ツールを使用して資料を採取したあと、技術員に連絡してください。保守情報収集ツールの使用方法については、“Systemwalker Centric Manager メッセージ説明書”の“保守情報の収集方法”を参照してください。
API格納場所
“アクション管理のAPI”を参照してください。
使用例
アクション停止APIの使用例を以下に示します。
#include "f3crhxac.h" unsigned char *AppName = "音声通知API" ; // 依頼元アプリケーション名 int kind = SOUND_VOICE ; // テキストの読み上げ unsigned char *text = "異常が発生しました。オペレータに連絡してください"; int repeat = 0 ; // 停止処理がされるまで繰り返す MpSoundParam *SndPrm = NULL ; // 省略値を使用 long lrc ; long handle ; // アクション実行APIの戻り値 /* 音声通知依頼 */ lrc = Mp_PlaySound2(AppName,kind,text,repeat,NULL,NULL) ; if ( lrc < 0 ) { /* エラー処理 */ } handle = lrc ; … lrc = Mp_StopAction(AppName,handle) ; if ( lrc != 0 ) { /* エラー処理 */ } /* 正常終了 */