Функция 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.
Если функция завершается сбоем, возвращаемое значение представляет собой системный код ошибки. Список кодов ошибок см. в разделе Системные коды ошибок.
Комментарии
Обычно только члены локальной группы администраторов на компьютере, где удаляется задание расписания, могут успешно выполнять эту функцию. Если имя сервера, переданное в строке, на которую указывает параметр Servername , является удаленным сервером, то только члены локальной группы администраторов на сервере могут успешно выполнить эту функцию.
Если в следующем значении реестра задан наименьший бит (например, 0x00000001), пользователи, принадлежащие к группе Операторы сервера, также могут успешно выполнить эту функцию.
HKLM\System\CurrentControlSet\Control\Lsa\SubmitControl
Вызовите функцию NetScheduleJobEnum , чтобы получить идентификатор задания для одного или нескольких запланированных заданий.
Функция NetScheduleJobDel удаляет все задания, идентификаторы заданий которых находятся в диапазоне MinJobId до MaxJobId.
Чтобы удалить все запланированные задания на сервере, можно вызвать NetScheduleJobDel , указав MinJobId равным 0 и MaxJobId равным – 1. Чтобы удалить одно задание, укажите идентификатор задания как для параметра MinJobId , так и для параметра MaxJobId .
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | lmat.h (включая Lmat.h) |
| Библиотека | Netapi32.lib |
| DLL | Netapi32.dll |