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、具有 SP1 的 Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	atacct.h
Library	Mstask.lib
DLL	Mstask.dll