Поделиться через

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

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

Возвращаемый код/значение Описание
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