ホーム › System.TaskScheduler › IWeeklyTrigger

IWeeklyTrigger

COMIDispatch (デュアル)

📘 Microsoft Learn (日本語) · English

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

IID5038fc98-82ff-436d-8728-a512a57c9dc1継承元ITrigger呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl20

公式ドキュメント

週単位のスケジュールに基づいてタスクを開始するトリガーを表します。

解説(Remarks)

タスクが開始される時刻は StartBoundary プロパティで設定します。

タスク用の XML を独自に読み書きする場合、週単位トリガーは Task Scheduler スキーマの ScheduleByWeek 要素で指定します。

メソッド 6

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

vtbl 20 HRESULT get_DaysOfWeek(SHORT* pDays)

タスクを実行する曜日を取得または設定します。(Get)

pDays

SHORT*

inout

トリガーが起動する曜日を表すビットマスクを受け取る変数へのポインタである。

解説(Remarks)

次の表は、このプロパティで使用されるビットマスクの対応を示します。

曜日	16進数の値	10進数の値
日曜日	0X01	1
月曜日	0x02	2
火曜日	0X04	4
水曜日	0X08	8
木曜日	0X10	16
金曜日	0x20	32
土曜日	0X40	64

タスク用の XML を独自に読み書きする場合、曜日は Task Scheduler スキーマの DaysOfWeek 要素で指定します。

vtbl 21 HRESULT put_DaysOfWeek(SHORT days)

タスクを実行する曜日を取得または設定します。(Put)

days

SHORT

トリガーが起動する曜日を表すビットマスクを指定する。

解説(Remarks)

次の表は、このプロパティで使用されるビットマスクの対応を示します。

曜日	16進数の値	10進数の値
日曜日	0X01	1
月曜日	0x02	2
火曜日	0X04	4
水曜日	0X08	8
木曜日	0X10	16
金曜日	0x20	32
土曜日	0X40	64

タスク用の XML を独自に読み書きする場合、曜日は Task Scheduler スキーマの DaysOfWeek 要素で指定します。

vtbl 22 HRESULT get_WeeksInterval(SHORT* pWeeks)

スケジュール内の週の間隔を取得または設定します。(Get)

pWeeks

SHORT*

inout

トリガーが起動する週数間隔を受け取る変数へのポインタである。

解説(Remarks)

間隔を 1 にすると毎週のスケジュールになります。間隔を 2 にすると隔週のスケジュールになります。

タスク用の XML を独自に読み書きする場合、週単位スケジュールの間隔は Task Scheduler スキーマの WeeksInterval 要素で指定します。

vtbl 23 HRESULT put_WeeksInterval(SHORT weeks)

スケジュール内の週の間隔を取得または設定します。(Put)

weeks

SHORT

トリガーが起動する週数間隔を指定する。

解説(Remarks)

間隔を 1 にすると毎週のスケジュールになります。間隔を 2 にすると隔週のスケジュールになります。

タスク用の XML を独自に読み書きする場合、週単位スケジュールの間隔は Task Scheduler スキーマの WeeksInterval 要素で指定します。

vtbl 24 HRESULT get_RandomDelay(LPWSTR* pRandomDelay)

トリガーの開始時刻にランダムに追加される遅延時間を取得または設定します。(IWeeklyTrigger.get_RandomDelay)

pRandomDelay

LPWSTR*

inout

タスク開始に加算されるランダムな遅延の最大時間を ISO 8601 期間形式の文字列で受け取る出力ポインタである。SysFreeString で解放する。

vtbl 25 HRESULT put_RandomDelay(LPWSTR randomDelay)

トリガーの開始時刻にランダムに追加される遅延時間を取得または設定します。(IWeeklyTrigger.put_RandomDelay)

randomDelay

LPWSTR

タスク開始に加算するランダムな遅延の最大時間を ISO 8601 期間形式の文字列で指定する。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IWeeklyTrigger "{5038FC98-82FF-436D-8728-A512A57C9DC1}"
#usecom global IWeeklyTrigger IID_IWeeklyTrigger "{}"
#comfunc global IWeeklyTrigger_get_DaysOfWeek     20 var
#comfunc global IWeeklyTrigger_put_DaysOfWeek     21 int
#comfunc global IWeeklyTrigger_get_WeeksInterval  22 var
#comfunc global IWeeklyTrigger_put_WeeksInterval  23 int
#comfunc global IWeeklyTrigger_get_RandomDelay    24 var
#comfunc global IWeeklyTrigger_put_RandomDelay    25 wstr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_IWeeklyTrigger "{5038FC98-82FF-436D-8728-A512A57C9DC1}"
#usecom global IWeeklyTrigger IID_IWeeklyTrigger "{}"
#comfunc global IWeeklyTrigger_get_DaysOfWeek     20 sptr
#comfunc global IWeeklyTrigger_put_DaysOfWeek     21 int
#comfunc global IWeeklyTrigger_get_WeeksInterval  22 sptr
#comfunc global IWeeklyTrigger_put_WeeksInterval  23 int
#comfunc global IWeeklyTrigger_get_RandomDelay    24 sptr
#comfunc global IWeeklyTrigger_put_RandomDelay    25 wstr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。