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。

如果方法失敗，可能會傳回下列其中一個錯誤碼。

傳回碼 Description
COR_E_FILENOTFOUND
 工作不存在。
E_INVALIDARG
 pwszName 參數無效。
E_OUTOFMEMORY
 記憶體配置失敗。
SCHED_E_UNKNOWN_OBJECT_VERSION
 工作物件版本不受支援或無效。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 mstask.h
程式庫 Mstask.lib
Dll Mstask.dll
可轉散發套件 Windows NT 4.0 和 Windows 95 上的 Internet Explorer 4.0 或更新版本

另請參閱

ITask

ITaskScheduler