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

Статья
08/24/2023

[NetScheduleJobGetInfo больше недоступен для использования с Windows 8. Вместо этого используйте интерфейсы планировщика задач 2.0.

]

Функция NetScheduleJobGetInfo извлекает сведения о конкретном задании, помещенном в очередь на указанном компьютере. Для этой функции требуется запустить службу расписания.

Синтаксис

NET_API_STATUS NET_API_FUNCTION NetScheduleJobGetInfo(
  [in, optional] LPCWSTR Servername,
  [in]           DWORD   JobId,
  [out]          LPBYTE  *PointerToBuffer
);

Параметры

[in, optional] Servername

Указатель на константную строку, указывающую DNS или NetBIOS-имя удаленного сервера, на котором выполняется функция. Если этот параметр имеет значение NULL, используется локальный компьютер.

[in] JobId

Значение типа , указывающее идентификатор задания, для которого требуется получить сведения.

[out] PointerToBuffer

Указатель на буфер, получающий AT_INFO структуру, описывающую указанное задание. Этот буфер выделяется системой и должен быть освобожден с помощью функции NetApiBufferFree . Дополнительные сведения см. в разделах Буферы функций управления сетью и Длина буфера функции управления сетью.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет NERR_Success.

Если функция завершается сбоем, возвращаемое значение представляет собой системный код ошибки. Список кодов ошибок см. в разделе Системные коды ошибок.

Обычно только члены локальной группы администраторов на компьютере, где перечисляется задание расписания, могут успешно выполнять эту функцию. Если имя сервера, переданное в строке, на которую указывает параметр Servername , является удаленным сервером, то только члены локальной группы администраторов на сервере могут успешно выполнить эту функцию.

Если в следующем значении реестра задан наименьший бит (например, 0x00000001), пользователи, принадлежащие к группе Операторы сервера, также могут успешно выполнить эту функцию.

HKLM\System\CurrentControlSet\Control\Lsa\SubmitControl

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	lmat.h (включая Lmat.h)
Библиотека	Netapi32.lib
DLL	Netapi32.dll