ホーム › System.TaskScheduler › IShowMessageAction

IShowMessageAction

COMIDispatch (デュアル)

✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。

IID505e9e68-af89-46b8-a30f-56162a83d537継承元IAction呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl10

公式ドキュメント

タスクが起動されたときにメッセージボックスを表示するアクションを表します。

解説(Remarks)

メッセージボックスアクションを含むタスクでは、タスクが起動され、かつタスクが対話型ログオンの種類を持つ場合に、メッセージボックスが表示されます。タスクのログオンの種類を対話型に設定するには、タスクプリンシパルの LogonType プロパティ、または ITaskFolder::RegisterTask や ITaskFolder::RegisterTaskDefinition の logonType パラメーターに TASK_LOGON_INTERACTIVE_TOKEN または TASK_LOGON_GROUP を指定します。

タスク用に独自の XML を読み書きする場合、メッセージボックスアクションはタスクスケジューラースキーマの ShowMessage 要素を使用して指定します。

例

このインターフェースの詳細情報とサンプルコードについては、Message Box Example (C++) を参照してください。

メソッド 4

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 10 HRESULT get_Title(LPWSTR* pTitle)

メッセージボックスのタイトルを取得または設定します。(Get)

pTitle

LPWSTR*

inout

表示するメッセージボックスのタイトルを受け取る出力ポインタである。SysFreeString で解放する。

解説(Remarks)

メッセージボックスのタイトルテキストには、パラメーター化された文字列を使用できます。詳細については、IEventTrigger の ValueQueries プロパティの Examples セクションを参照してください。

このプロパティ値を設定する際、値はリソース .dll ファイルから取得したテキストにすることができます。リソースファイルからテキストを参照するには、特殊な形式の文字列を使用します。文字列の形式は $(@ [Dll], [ResourceID]) で、[Dll] はリソースを含む .dll ファイルへのパス、[ResourceID] はリソーステキストの識別子です。たとえば、このプロパティ値を $(@ %SystemRoot%\System32\ResourceName.dll, -101) に設定すると、%SystemRoot%\System32\ResourceName.dll ファイル内の識別子が -101 のリソーステキストの値がプロパティに設定されます。

vtbl 11 HRESULT put_Title(LPWSTR title)

メッセージボックスのタイトルを取得または設定します。(Put)

title

LPWSTR

表示するメッセージボックスのタイトルを指定する。

解説(Remarks)

vtbl 12 HRESULT get_MessageBody(LPWSTR* pMessageBody)

メッセージボックスの本文に表示されるメッセージテキストを取得または設定します。(Get)

pMessageBody

LPWSTR*

inout

表示するメッセージ本文を受け取る出力ポインタである。SysFreeString で解放する。

解説(Remarks)

メッセージボックスのメッセージテキストには、パラメーター化された文字列を使用できます。詳細については、IEventTrigger の ValueQueries プロパティの Examples セクションを参照してください。

vtbl 13 HRESULT put_MessageBody(LPWSTR messageBody)

メッセージボックスの本文に表示されるメッセージテキストを取得または設定します。(Put)

messageBody

LPWSTR

表示するメッセージ本文を指定する。

解説(Remarks)

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数:

#define global IID_IShowMessageAction "{505E9E68-AF89-46B8-A30F-56162A83D537}"
#usecom global IShowMessageAction IID_IShowMessageAction "{}"
#comfunc global IShowMessageAction_get_Title        10 var
#comfunc global IShowMessageAction_put_Title        11 wstr
#comfunc global IShowMessageAction_get_MessageBody  12 var
#comfunc global IShowMessageAction_put_MessageBody  13 wstr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_IShowMessageAction "{505E9E68-AF89-46B8-A30F-56162A83D537}"
#usecom global IShowMessageAction IID_IShowMessageAction "{}"
#comfunc global IShowMessageAction_get_Title        10 sptr
#comfunc global IShowMessageAction_put_Title        11 wstr
#comfunc global IShowMessageAction_get_MessageBody  12 sptr
#comfunc global IShowMessageAction_put_MessageBody  13 wstr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。