NetScheduleJobDel 函式 (lmat.h)
[NetScheduleJobDel 已不再可供 Windows 8 使用。 請改用 工作排程器 2.0 介面。
]
NetScheduleJobDel函式會刪除一系列排入佇列以在電腦執行的工作。 此函式要求排程服務必須在傳送作業刪除要求的電腦啟動。
語法
NET_API_STATUS NET_API_FUNCTION NetScheduleJobDel(
[in, optional] LPCWSTR Servername,
[in] DWORD MinJobId,
[in] DWORD MaxJobId
);
參數
[in, optional] Servername
常數位符串的指標,指定要執行函式之遠端伺服器的 DNS 或 NetBIOS 名稱。 如果此參數為 Null,則會使用本機電腦。
[in] MinJobId
最小作業識別碼。 若作業識別碼小於 MinJobId 的作業,將不會刪除。
[in] MaxJobId
工作識別碼上限。 作業識別碼大於 MaxJobId 的作業將不會刪除。
傳回值
如果函式成功,傳回值會NERR_Success。
如果函式失敗,則傳回值是系統錯誤碼。 如需錯誤碼的清單,請參閱 系統錯誤碼。
備註
通常只有刪除排程工作之電腦上的本機 Administrators 群組成員可以順利執行此函式。 如果 Servername 參數所指向字串中所傳遞的伺服器名稱是遠端伺服器,則只有伺服器上的本機 Administrators 群組成員可以成功執行此函式。
例如,如果下列登錄值具有最小有效位集 (,0x00000001) ,則屬於伺服器操作員群組的使用者也可以順利執行此函式。
HKLM\System\CurrentControlSet\Control\Lsa\SubmitControl
呼叫 NetScheduleJobEnum 函式,以擷取一或多個排程工作的作業識別碼。
NetScheduleJobDel函式會刪除工作識別碼在MinJobId 範圍中透過 MaxJobId的所有作業。
若要刪除伺服器上的所有排程工作,您可以呼叫 NetScheduleJobDel ,指定 MinJobId 等於 0, 而 MaxJobId 等於 – 1。 若要刪除一個作業,請同時指定 MinJobId 參數和 MaxJobId 參數的作業識別碼。
需求
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | lmat.h (include Lmat.h) |
程式庫 | Netapi32.lib |
Dll | Netapi32.dll |