ITaskScheduler::Activate メソッド (mstask.h)

[[この API は、以降のバージョンのオペレーティングシステムまたは製品で変更または使用できない場合があります。代わりに、タスクスケジューラ 2.0 インターフェイスを使用してください。 ]

Activate メソッドは、指定された作業項目のアクティブなインターフェイスを返します。

構文

HRESULT Activate(
  [in]  LPCWSTR  pwszName,
  [in]  REFIID   riid,
  [out] IUnknown **ppUnk
);

[in] pwszName

アクティブにする作業項目の名前を指定する null で終わる文字列。

[in] riid

要求されるインターフェイスを識別する識別子。現時点でサポートされている唯一のインターフェイスである ITask には、識別子IID_ITaskがあります。

[out] ppUnk

要求されたインターフェイスのアドレスを受け取るインターフェイスポインターへのポインター。

このメソッドが成功すると、S_OKが返されます。

メソッドが失敗した場合は、次のいずれかのエラーコードが返される可能性があります。

リターンコード	説明
COR_E_FILENOTFOUND	タスクが存在しません。
E_INVALIDARG	pwszName パラメーターが無効です。
E_OUTOFMEMORY	メモリ割り当てに失敗しました。
SCHED_E_UNKNOWN_OBJECT_VERSION	タスクオブジェクトのバージョンがサポートされていないか無効です。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	mstask.h
Library	Mstask.lib
[DLL]	Mstask.dll
再頒布可能パッケージ	Windows NT 4.0 および Windows 95 のインターネットエクスプローラー 4.0 以降