Функция SetNetScheduleAccountInformation (atacct.h)

Статья
03/14/2023

[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 указывает, что имя учетной записи и пароль успешно заданы. Любое другое значение указывает на ошибку.

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

Возвращаемый код/значение	Описание
E_ACCESSDENIED 0x080070005	В доступе было отказано. Эта ошибка возвращается, если вызывающий объект не был членом группы администраторов. Эта ошибка также возвращается, если параметр pwszAccount не имеет значения NULL , что указывает на именованную учетную запись, а не локальную системную учетную запись, а параметр pwszPassword был неверным для учетной записи, указанной в параметре pwszAccount .
HRESULT_FROM_WIN32(ERROR_INVALID_DATA) 0x08007000d	Недопустимые данные. Эта ошибка возвращается, если параметр pwszPassword имеет значение NULL или длина строки параметра pwszPassword была слишком длинной.
SCHED_E_ACCOUNT_NAME_NOT_FOUND 0x80041310	Не удалось установить существование указанной учетной записи. Эта ошибка возвращается, если параметр pwszAccount не имеет значения NULL , что указывает на именованную учетную запись, а не локальную системную учетную запись и не удалось найти параметр pwszAccount .

SetNetScheduleAccountInformation олицетворяет вызывающий объект. Эту функцию могут успешно выполнять только члены локальной группы администраторов на компьютере, на котором задаются сведения о запланированной учетной записи. Обратите внимание, что пароли NULL не допускаются.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista, Windows XP с пакетом обновления 1 (SP1) [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	atacct.h
Библиотека	Mstask.lib
DLL	Mstask.dll

См. также раздел

GetNetScheduleAccountInformation

Share via