IPrincipal

プリンシパルのセキュリティ資格情報を提供します。

アカウントを指定する際は、ドメイン名とユーザー名を指定するために、コード内で二重のバックスラッシュを正しく使用することを忘れないでください。たとえば、UserId プロパティの値を指定するには DOMAIN\UserName を使用します。

タスクの XML を読み書きする際、プリンシパルのセキュリティ資格情報は Task Scheduler スキーマの Principal 要素で指定します。

at.exe コマンドラインツールを使用してタスクが登録され、このインターフェースを使用してそのタスクの情報を取得する場合、LogonType プロパティは 0 を返し、RunLevel プロパティは 0 を返し、UserId プロパティは NULL を返します。

例

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

プリンシパルの識別子を取得または設定します。(Get)

この識別子は、IActionCollection::Context プロパティを指定する際にも使用されます。

タスクの XML を読み書きする際、プリンシパルの識別子は Task Scheduler スキーマの Principal 要素の Id 属性で指定します。

プリンシパルの識別子を取得または設定します。(Put)

この識別子は、IActionCollection::Context プロパティを指定する際にも使用されます。

タスクの XML を読み書きする際、プリンシパルの識別子は Task Scheduler スキーマの Principal 要素の Id 属性で指定します。

プリンシパルの名前を取得または設定します。(Get)

タスクの XML を読み書きする際、プリンシパルの表示名は Task Scheduler スキーマの DisplayName 要素で指定します。

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

プリンシパルの名前を取得または設定します。(Put)

タスクの XML を読み書きする際、プリンシパルの表示名は Task Scheduler スキーマの DisplayName 要素で指定します。

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

プリンシパルに関連付けられたタスクの実行に必要なユーザー識別子を取得または設定します。(Get)

GroupId プロパティにグループ識別子が指定されている場合は、このプロパティを設定しないでください。

タスクの XML を読み書きする際、プリンシパルのユーザー識別子は Task Scheduler スキーマの UserId 要素で指定します。

プリンシパルに関連付けられたタスクの実行に必要なユーザー識別子を取得または設定します。(Put)

GroupId プロパティにグループ識別子が指定されている場合は、このプロパティを設定しないでください。

タスクの XML を読み書きする際、プリンシパルのユーザー識別子は Task Scheduler スキーマの UserId 要素で指定します。

プリンシパルに関連付けられたタスクの実行に必要なセキュリティログオン方法を取得または設定します。(Get)

このプロパティは、UserId プロパティによってユーザー識別子が指定されている場合にのみ有効です。

タスクの XML を読み書きする際、ログオンの種類は Task Scheduler スキーマの <LogonType> 要素で指定します。

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

バッテリー節約機能が有効な場合、Windows タスクスケジューラのタスクは、次の条件を満たすタスクのみがトリガーされます。

• コンピューターがアイドル状態の場合にのみタスクを開始する... に設定されていない(タスクが IdleSettings を使用していない)
• 自動メンテナンス中に実行するように設定されていない(タスクが MaintenanceSettings を使用していない)
• ユーザーがログオンしているときのみ実行する に設定されている(タスクの LogonType が TASK_LOGON_INTERACTIVE_TOKEN または TASK_LOGON_GROUP)

その他のすべてのトリガーは、バッテリー節約機能が無効になるまで遅延されます。アプリケーションでバッテリー節約機能の状態にアクセスする方法の詳細については、SYSTEM_POWER_STATUS を参照してください。バッテリー節約機能に関する一般的な情報については、battery saver (in the hardware component guidelines) を参照してください。

プリンシパルに関連付けられたタスクの実行に必要なセキュリティログオン方法を取得または設定します。(Put)

このプロパティは、UserId プロパティによってユーザー識別子が指定されている場合にのみ有効です。

タスクの XML を読み書きする際、ログオンの種類は Task Scheduler スキーマの <LogonType> 要素で指定します。

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

バッテリー節約機能が有効な場合、Windows タスクスケジューラのタスクは、次の条件を満たすタスクのみがトリガーされます。

• コンピューターがアイドル状態の場合にのみタスクを開始する... に設定されていない(タスクが IdleSettings を使用していない)
• 自動メンテナンス中に実行するように設定されていない(タスクが MaintenanceSettings を使用していない)
• ユーザーがログオンしているときのみ実行する に設定されている(タスクの LogonType が TASK_LOGON_INTERACTIVE_TOKEN または TASK_LOGON_GROUP)

その他のすべてのトリガーは、バッテリー節約機能が無効になるまで遅延されます。アプリケーションでバッテリー節約機能の状態にアクセスする方法の詳細については、SYSTEM_POWER_STATUS を参照してください。バッテリー節約機能に関する一般的な情報については、battery saver (in the hardware component guidelines) を参照してください。

プリンシパルに関連付けられたタスクの実行に必要なユーザーグループの識別子を取得または設定します。(Get)

UserId プロパティにユーザー識別子が指定されている場合は、このプロパティを設定しないでください。

タスクの XML を読み書きする際、プリンシパルのグループ識別子は Task Scheduler スキーマの GroupId 要素で指定します。

プリンシパルに関連付けられたタスクの実行に必要なユーザーグループの識別子を取得または設定します。(Put)

UserId プロパティにユーザー識別子が指定されている場合は、このプロパティを設定しないでください。

タスクの XML を読み書きする際、プリンシパルのグループ識別子は Task Scheduler スキーマの GroupId 要素で指定します。

プリンシパルに関連付けられたタスクの実行に必要な特権レベルを指定するために使用される識別子を取得または設定します。(Get)

Builtin\Administrator アカウント、または Local System や Local Service アカウントを使用してタスクが登録された場合、RunLevel プロパティは無視されます。また、ユーザーアカウント制御 (UAC) が無効になっている場合も、このプロパティ値は無視されます。

タスクのセキュリティコンテキストに Administrators グループを使用してタスクが登録された場合、そのタスクを実行するには、RunLevel プロパティを TASK_RUNLEVEL_HIGHEST に設定する必要もあります。詳細については、Security Contexts for Tasks を参照してください。

プリンシパルに関連付けられたタスクの実行に必要な特権レベルを指定するために使用される識別子を取得または設定します。(Put)

Builtin\Administrator アカウント、または Local System や Local Service アカウントを使用してタスクが登録された場合、RunLevel プロパティは無視されます。また、ユーザーアカウント制御 (UAC) が無効になっている場合も、このプロパティ値は無視されます。

タスクのセキュリティコンテキストに Administrators グループを使用してタスクが登録された場合、そのタスクを実行するには、RunLevel プロパティを TASK_RUNLEVEL_HIGHEST に設定する必要もあります。詳細については、Security Contexts for Tasks を参照してください。

#define global IID_IPrincipal "{D98D51E5-C9B4-496A-A9C1-18980261CF0F}"
#usecom global IPrincipal IID_IPrincipal "{}"
#comfunc global IPrincipal_get_Id           7 var
#comfunc global IPrincipal_put_Id           8 wstr
#comfunc global IPrincipal_get_DisplayName  9 var
#comfunc global IPrincipal_put_DisplayName  10 wstr
#comfunc global IPrincipal_get_UserId       11 var
#comfunc global IPrincipal_put_UserId       12 wstr
#comfunc global IPrincipal_get_LogonType    13 var
#comfunc global IPrincipal_put_LogonType    14 int
#comfunc global IPrincipal_get_GroupId      15 var
#comfunc global IPrincipal_put_GroupId      16 wstr
#comfunc global IPrincipal_get_RunLevel     17 var
#comfunc global IPrincipal_put_RunLevel     18 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。