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

3.11 Mp_ExecRemoteCmd（）関数

■機能説明

Mp_OpenRemoteCmd（）関数発行後、Mp_ExecRemoteCmd（）関数を発行することにより、コマンド要求を行います。

■呼び出し形式

#include <mp_opagt_api.h>
int Mp_ExecRemoteCmd( fp, node, NodeID, DatabaseID, cmdtext,
                      execflag );

HANDLE fp;          /*  Mp_OpenRemoteCmd()で獲得したハンドル */
char   *node;       /*  コマンド要求先のノード名を指定する   */
DWORD  *NodeID;     /*  NULLを指定する                       */
DWORD  *DatabaseID; /*  NULLを指定する                       */
char   *cmdtext;    /*  発行するコマンドテキストを指定する   */
int    execflag;    /*  コマンド実行フラグを指定する         */

■パラメタ

fp:

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

node:

コマンド要求先システムのノード名を128バイト以内で指定します。

cmdtext:

発行するコマンドテキストを2047バイト以内で指定します。

execflag:

コマンドを実行する際の条件をフラグで指定します。execflagは、いくつかのグループで構成され、各グループから1つ値を選択できます。

実行権限フラグ   (Windows NT(R)、Windows(R) 2000、Windows Server(TM) 2003では無効)
  OP_CMD_NOROOT     :  コマンド要求先システムで定義されたコ
                       マンドシェルおよび利用者権限でコマン
                       ドが実行されます(デフォルト)。
  OP_CMD_ROOT       :  コマンド要求先システムの、デフォルト
                       のコマンドシェルおよび特権利用者権限
                       でコマンドが実行されます。
応答フラグ
  OP_CMD_REPLY      :  コマンド結果応答およびコマンド最終応
                       答を受け取ることができます(デフォル
                       ト)。
  OP_CMD_NOREPLY    :  コマンド結果応答を受け取ることはでき
                       ません。コマンド最終応答だけ受け取る
                       ことができます。
ロギングフラグ
  OP_CMD_LOG        :  コマンド要求、コマンド結果応答、コマ
                       ンド最終応答のデータをロギングします
                       (デフォルト)。
  OP_CMD_NOLOG      :  コマンド要求、コマンド結果応答、コマ
                       ンド最終応答のデータをロギングしませ
                       ん。

■復帰値

−1以外:

正常終了。コマンド要求とコマンド応答を対応づけるための識別子。

−1:

異常終了。詳細なエラーコードは、GetLastError（）で取得してください。