IScheduledWorkItem：：GetExitCode 方法 (mstask.h)

  • 發行項

[[此 API 可能會在後續版本的操作系統或產品中變更或無法使用。 請改用 工作排程器 2.0 介面 。] ]

擷取上次執行時，與 工作專案 相關聯的可執行檔所傳回的最後一個結束代碼。 方法也會傳回上次嘗試執行工作項目時傳回給工作排程器的結束代碼。

語法

HRESULT GetExitCode(
  [out] DWORD *pdwExitCode
);

參數

[out] pdwExitCode

DWORD 值的指標，設定為工作項目的最後一個結束代碼。 這是工作專案上次停止執行時所傳回的結束代碼。 如果工作專案從未啟動，則會傳回 0。

傳回值

GetExitCode 方法會從上次嘗試啟動工作項目傳回錯誤。 可能的值如下。

傳回碼 描述
S_OK
 嘗試啟動工作專案成功。
SCHED_S_TASK_HAS_NOT_RUN
 尚未嘗試啟動此工作專案。
E_INVALIDARG
 自變數無效。
E_OUTOFMEMORY
 記憶體不足。

備註

這個方法可以傳回下列兩項資訊：

  • pdwExitCode 參數中會傳回排程可執行檔所傳回的錯誤或結束代碼。
  • 當工作排程器嘗試啟動作業時所收到的錯誤碼，會在 GetExitCode 方法呼叫本身中傳回。
若要取得更新的錯誤碼，請一律先呼叫 ITaskScheduler：：Activate 以取得新的 IScheduledWorkItem 介面，然後可用來取得更新的錯誤碼。

範例

如需如何擷取工作建立者的範例，請參閱 C/C++ 程式代碼範例：擷取工作結束代碼。

規格需求

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

另請參閱

IScheduledWorkItem