IPrincipal インターフェイス (taskschd.h)
プリンシパルのセキュリティ資格情報を提供します。 これらのセキュリティ資格情報は、プリンシパルに関連付けられているタスクのセキュリティ コンテキストを定義します。
継承
IPrincipal インターフェイスは、IDispatch インターフェイスから継承されます。
メソッド
IPrincipal インターフェイスには、これらのメソッドがあります。
| IPrincipal::get_DisplayName プリンシパルの名前を取得または設定します。 (Get) |
| IPrincipal::get_GroupId プリンシパルに関連付けられているタスクを実行するために必要なユーザー グループの識別子を取得または設定します。 (Get) |
| IPrincipal::get_Id プリンシパルの識別子を取得または設定します。 (Get) |
| IPrincipal::get_LogonType プリンシパルに関連付けられているタスクを実行するために必要なセキュリティ ログオン 方法を取得または設定します。 (Get) |
| IPrincipal::get_RunLevel プリンシパルに関連付けられているタスクを実行するために必要な特権レベルを指定するために使用される識別子を取得または設定します。 (Get) |
| IPrincipal::get_UserId プリンシパルに関連付けられているタスクを実行するために必要なユーザー識別子を取得または設定します。 (Get) |
| IPrincipal::p ut_DisplayName プリンシパルの名前を取得または設定します。 (Put) |
| IPrincipal::p ut_GroupId プリンシパルに関連付けられているタスクを実行するために必要なユーザー グループの識別子を取得または設定します。 (Put) |
| IPrincipal::p ut_Id プリンシパルの識別子を取得または設定します。 (Put) |
| IPrincipal::p ut_LogonType プリンシパルに関連付けられているタスクを実行するために必要なセキュリティ ログオン 方法を取得または設定します。 (Put) |
| IPrincipal::p ut_RunLevel プリンシパルに関連付けられているタスクを実行するために必要な特権レベルを指定するために使用される識別子を取得または設定します。 (Put) |
| IPrincipal::p ut_UserId プリンシパルに関連付けられているタスクを実行するために必要なユーザー識別子を取得または設定します。 (Put) |
注釈
アカウントを指定するときは、ドメインとユーザー名を指定するために、コードで二重円記号を適切に使用することを忘れないでください。 たとえば、DOMAIN\UserName を使用して UserId プロパティの値を指定します。
タスクの XML の読み取りまたは書き込み時に、プリンシパルのセキュリティ資格情報は、タスク スケジューラ スキーマの Principal 要素で指定されます。
at.exe コマンド ライン ツールを使用してタスクを登録し、このインターフェイスを使用してタスクに関する情報を取得する場合、 LogonType プロパティは 0 を返し、 RunLevel プロパティは 0 を返し、 UserId プロパティは NULL を返します。
例
このインターフェイスの詳細とコード例については、「 タイム トリガーの例 (C++)」 または「 登録トリガーの例 (C++)」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | taskschd.h |