[[此 API 可能會在後續版本的操作系統或產品中變更或無法使用。 請改用 工作排程器 2.0 介面 。] ]
這個方法會將特定應用程式指派給目前的 工作。
語法
HRESULT SetApplicationName(
[in] LPCWSTR pwszApplicationName
);
參數
[in] pwszApplicationName
以 Null 結尾的字串，其中包含將與工作相關聯的應用程式名稱。 使用空字串清除應用程式名稱。
傳回值
SetApplicationName 方法會傳回下列其中一個值。
| 傳回碼 | 描述 |
|---|---|
|
作業成功。 |
|
自變數無效。 |
|
記憶體不足。 |
備註
如果您未指定應用程式的路徑，工作排程器會搜尋環境路徑以尋找正確的路徑。 如果應用程式名稱指定程式，則名稱應該使用 .exe 延伸模組，以確保工作排程器使用者介面正確顯示應用程式的圖示。
呼叫 SetApplicationName 之後，請確定您呼叫 IPersistFile：：Save 將修改的工作儲存到磁碟。
範例
如需如何設定應用程式名稱的範例，請參閱 C/C++ 程式代碼範例：設定應用程式名稱。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | mstask.h |
| 程式庫 | Mstask.lib |
| Dll | Mstask.dll |
| 可轉散發套件 | Windows NT 4.0 和 Windows 95 上的 Internet Explorer 4.0 或更新版本 |