SetNetScheduleAccountInformation function (atacct.h)
[SetNetScheduleAccountInformation is no longer available for use as of Windows 8. Instead, use the Task Scheduler 2.0 Interfaces.
]
The SetNetScheduleAccountInformation function sets the AT Service account name and password. The AT Service account name and password are used as the credentials for scheduled jobs created with NetScheduleJobAdd.
Syntax
HRESULT SetNetScheduleAccountInformation(
[in] LPCWSTR pwszServerName,
[in] LPCWSTR pwszAccount,
[in] LPCWSTR pwszPassword
);
Parameters
[in] pwszServerName
A NULL-terminated wide character string for the name of the computer whose account information is being set.
[in] pwszAccount
A pointer to a NULL-terminated wide character string for the account. To specify the local system account, set this parameter to NULL.
[in] pwszPassword
A pointer to a NULL-terminated wide character string for the password. For information about securing password information, see Handling Passwords.
Return value
The return value is an HRESULT. A value of S_OK indicates the account name and password were successfully set. Any other value indicates an error condition.
If the function fails, some of the possible return values are listed below.
| Return code/value | Description |
|---|---|
|
Access was denied. This error is returned if the caller was not a member of the Administrators group. This error is also returned if the pwszAccount parameter was not NULL indicating a named account not the local system account and the pwszPassword parameter was incorrect for the account specified in the pwszAccount parameter. |
|
The data is invalid. This error is returned if the pwszPassword parameter was NULL or the length of pwszPassword parameter string was too long. |
|
Unable to establish existence of the account specified. This error is returned if the pwszAccount parameter was not NULL indicating a named account not the local system account and the pwszAccount parameter could not be found. |
Remarks
The SetNetScheduleAccountInformation impersonates the caller. Only members of the local Administrators group on the computer where the schedule account information is being set can successfully execute this function. Note that NULL passwords are not allowed.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista, Windows XP with SP1 [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | atacct.h |
| Library | Mstask.lib |
| DLL | Mstask.dll |