Метод ITaskFolder::RegisterTask (taskschd.h)
Регистрирует (создает) новую задачу в папке с помощью XML для определения задачи.
Синтаксис
HRESULT RegisterTask(
[in] BSTR path,
[in] BSTR xmlText,
[in] LONG flags,
[in] VARIANT userId,
[in] VARIANT password,
[in] TASK_LOGON_TYPE logonType,
[in, optional] VARIANT sddl,
[out] IRegisteredTask **ppTask
);
Параметры
[in] path
Имя данной задачи. Если это значение равно NULL, задача будет зарегистрирована в корневой папке задач, а имя задачи будет значением GUID, созданным службой планировщика задач.
Имя задачи не может начинаться или заканчиваться пробелом. Символ "." не может использоваться для указания текущей папки задач и .. Символы нельзя использовать для указания родительской папки задач в пути.
[in] xmlText
Определение задачи в формате XML.
В следующих разделах содержатся задачи, определенные с помощью XML.
- Пример триггера времени (XML)
- Пример триггера события (XML)
- Пример ежедневного триггера (XML)
- Пример триггера регистрации (XML)
- Пример еженедельного триггера (XML)
- Пример триггера входа в систему (XML)
- Пример триггера загрузки (XML)
[in] flags
[in] userId
Учетные данные пользователя, используемые для регистрации задачи.
[in] password
Пароль для userId, используемого для регистрации задачи. При использовании типа входа TASK_LOGON_SERVICE_ACCOUNT пароль должен быть пустым значением VARIANT , например VT_NULL или VT_EMPTY.
[in] logonType
Значение , определяющее, какой метод входа используется для запуска зарегистрированной задачи.
[in, optional] sddl
Дескриптор безопасности, связанный с зарегистрированной задачей. Вы можете указать список управления доступом (ACL) в дескрипторе безопасности для задачи, чтобы разрешить или запретить определенным пользователям и группам доступ к задаче.
[out] ppTask
Интерфейс IRegisteredTask , представляющий новую задачу.
Передайте ссылку на указатель интерфейса IRegisteredTaskNULL. Ссылка на указатель, отличный от NULL , может привести к утечке памяти, так как указатель будет перезаписан.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
Возвращаемый код или значение | Описание |
---|---|
|
Операция выполнена успешно. |
|
Доступ запрещен для подключения к службе планировщика задач. |
|
Приложение не имеет достаточно памяти для выполнения операции или пользователь или пароль имеет по крайней мере одно значение NULL и одно значение, отличное от NULL. |
|
Задача зарегистрирована, но может не запуститься. Для субъекта задачи необходимо включить привилегию пакетного входа. |
|
Задача зарегистрирована, но не все указанные триггеры запускают ее. |
Комментарии
Для задачи, которая содержит действие окна сообщения, окно сообщения будет отображаться, если задача активирована и задача имеет тип интерактивного входа. Чтобы задать интерактивный тип входа в задачу, укажите TASK_LOGON_INTERACTIVE_TOKEN или TASK_LOGON_GROUP в свойстве LogonType субъекта задачи или в параметре logonTypeобъекта ITaskFolder::RegisterTask или ITaskFolder::RegisterTaskDefinition.
Только член группы Администраторы может создать задачу с триггером загрузки.
Вы можете успешно зарегистрировать задачу в группе, указанной в параметре userId , и TASK_LOGON_INTERACTIVE_TOKEN , указанной в параметре logonTypeITaskFolder::RegisterTask или ITaskFolder::RegisterTaskDefinition, но задача не будет выполняться.
Передача значений TASK_VALIDATE_ONLY и TASK_IGNORE_REGISTRATION_TRIGGERS в параметр flags является недопустимым аргументом.
Если задача определяет сеть, которая не существует в параметрах NetworkSettings задачи, метод ITaskFolder::RegisterTask возвратит ошибку 0x8000ffff при регистрации задачи.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows Vista [только классические приложения] |
Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
Целевая платформа | Windows |
Header | taskschd.h |
Библиотека | Taskschd.lib |
DLL | Taskschd.dll |
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по