COleDocObjectItem::ExecCommand

更新 : 2007 年 11 月

ユーザーが指定したコマンドを実行します。

HRESULT ExecCommand(
   DWORD nCmdID,
   DWORD nCmdExecOpt = OLECMDEXECOPT_DONTPROMPTUSER,
   const GUID* pguidCmdGroup = NULL 
);

パラメータ

nCmdID
実行するコマンドの ID。pguidCmdGroup で指定したグループのコマンドを指定します。
nCmdExecOpt
コマンド実行オプションを指定します。既定では、ユーザーに確認せずに、コマンドが実行されます。値の一覧については、「OLECMDEXECOPT」を参照してください。
pguidCmdGroup
コマンドグループの一意な ID。既定では、標準グループを指定する NULL です。nCmdID で渡すコマンドの所属先グループを指定します。

正常終了した場合は S_OK を返します。それ以外の場合は次のいずれかのエラーコードを返します。

値	説明
E_UNEXPECTED	予期しないエラーが発生しました。
E_FAIL	エラーが発生しました。
E_NOTIMPL	MFC 自体でコマンドの変換およびディスパッチを行う必要があることを示します。
OLECMDERR_E_UNKNOWNGROUP	pguidCmdGroup は NULL 以外ですが、正しいコマンドグループを示していません。
OLECMDERR_E_NOTSUPPORTED	nCmdID は、pGroup グループの有効なコマンドとして認識されません。
OLECMDERR_DISABLED	nCmdID で指定されたコマンドは無効であり、実行できません。
OLECMDERR_NOHELP	nCmdID で指定されたコマンドのヘルプを呼び出し元が要求しましたが、ヘルプがありません。
OLECMDERR_CANCELLED	ユーザーが実行をキャンセルしました。