Функция SetNetScheduleAccountInformation (atacct.h)
[SetNetScheduleAccountInformation больше недоступен для использования с Windows 8. Вместо этого используйте интерфейсы планировщика задач 2.0.
]
Функция SetNetScheduleAccountInformation задает имя и пароль учетной записи службы AT. Имя и пароль учетной записи службы AT используются в качестве учетных данных для запланированных заданий, созданных с помощью NetScheduleJobAdd.
Синтаксис
HRESULT SetNetScheduleAccountInformation(
[in] LPCWSTR pwszServerName,
[in] LPCWSTR pwszAccount,
[in] LPCWSTR pwszPassword
);
Параметры
[in] pwszServerName
Строка расширенных символов, завершающаяся значением NULL, для имени компьютера, для которого задаются сведения об учетной записи.
[in] pwszAccount
Указатель на строку расширенных символов, завершаемую NULL для учетной записи. Чтобы указать учетную запись локальной системы, присвойте этому параметру значение NULL.
[in] pwszPassword
Указатель на строку расширенных символов для пароля, завершаемую null. Сведения о защите сведений о паролях см. в разделе Обработка паролей.
Возвращаемое значение
Возвращаемое значение — HRESULT. Значение S_OK указывает, что имя учетной записи и пароль успешно заданы. Любое другое значение указывает на ошибку.
Если функция завершается сбоем, некоторые из возможных возвращаемых значений перечислены ниже.
| Возвращаемый код/значение | Описание |
|---|---|
|
В доступе было отказано. Эта ошибка возвращается, если вызывающий объект не был членом группы администраторов. Эта ошибка также возвращается, если параметр pwszAccount не имеет значения NULL , что указывает на именованную учетную запись, а не локальную системную учетную запись, а параметр pwszPassword был неверным для учетной записи, указанной в параметре pwszAccount . |
|
Недопустимые данные. Эта ошибка возвращается, если параметр pwszPassword имеет значение NULL или длина строки параметра pwszPassword была слишком длинной. |
|
Не удалось установить существование указанной учетной записи. Эта ошибка возвращается, если параметр pwszAccount не имеет значения NULL , что указывает на именованную учетную запись, а не локальную системную учетную запись и не удалось найти параметр pwszAccount . |
Комментарии
SetNetScheduleAccountInformation олицетворяет вызывающий объект. Эту функцию могут успешно выполнять только члены локальной группы администраторов на компьютере, на котором задаются сведения о запланированной учетной записи. Обратите внимание, что пароли NULL не допускаются.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista, Windows XP с пакетом обновления 1 (SP1) [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | atacct.h |
| Библиотека | Mstask.lib |
| DLL | Mstask.dll |