IProvideTaskPage::GetPage メソッド (mstask.h)
[[この API は、以降のバージョンのオペレーティング システムまたは製品で変更または使用できない場合があります。 代わりに タスク スケジューラ 2.0 インターフェイス を使用してください。] ]
このメソッドは、タスク オブジェクトに関連付けられている 1 つ以上のプロパティ シート ページを取得します。
構文
HRESULT GetPage(
[in] TASKPAGE tpType,
[in] BOOL fPersistChanges,
[out] HPROPSHEETPAGE *phPage
);
パラメーター
[in] tpType
返すページを指定する次のいずれかの TASKPAGE 列挙値。
TASKPAGE_TASK
[全般] ページ プロパティ。
TASKPAGE_SCHEDULE
タスクのプロパティをスケジュールします。
TASKPAGE_SETTINGS
タスクの設定プロパティ。
[in] fPersistChanges
タスク オブジェクトに対する変更を自動的に永続的に行うかどうかを指定します。 TRUE の場合、ページは、リリース時に変更が行われた場合に永続的なタスク オブジェクトを自動的に更新します。 FALSE の場合、呼び出し元は、タスク オブジェクトに対して IPersistFile::Save を呼び出すことによって、タスク オブジェクトの変更を永続的にする必要があります。
[out] phPage
タスク オブジェクトの返されたプロパティ シート ページを処理します。 その後、このハンドルを使用してページを表示できます。
戻り値
メソッドが成功した場合はS_OKを返し、タスクがディスクに保存されていない場合はSTG_E_NOTFILEBASEDSTORAGEを返します。
注釈
IProvideTaskPage インターフェイスを取得するには、ITask::QueryInterface を呼び出します。
次のコードは、このメソッドを使用する場合と ITask::QueryInterface を呼び出すための変数宣言と呼び出し構文を示しています。
例
既知のタスクの一般的なタスク ページの取得と表示の完全な例については、「タスク ページの取得の例」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | mstask.h |
| Library | Mstask.lib |
| [DLL] | Mstask.dll |
| 再頒布可能パッケージ | Windows NT 4.0 および Windows 95 のインターネット エクスプローラー 4.0 以降 |