Функция NetScheduleJobDel (lmat.h)

Статья
08/24/2023

[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