Función SetNetScheduleAccountInformation (atacct.h)
[SetNetScheduleAccountInformation ya no está disponible para su uso a partir de Windows 8. En su lugar, use las interfaces del Programador de tareas 2.0.
]
La función SetNetScheduleAccountInformation establece el nombre y la contraseña de la cuenta del servicio AT. El nombre y la contraseña de la cuenta del servicio AT se usan como credenciales para los trabajos programados creados con NetScheduleJobAdd.
Sintaxis
HRESULT SetNetScheduleAccountInformation(
[in] LPCWSTR pwszServerName,
[in] LPCWSTR pwszAccount,
[in] LPCWSTR pwszPassword
);
Parámetros
[in] pwszServerName
Cadena de caracteres anchos terminada en NULL para el nombre del equipo cuya información de cuenta se va a establecer.
[in] pwszAccount
Puntero a una cadena de caracteres anchos terminada en NULL para la cuenta. Para especificar la cuenta del sistema local, establezca este parámetro en NULL.
[in] pwszPassword
Puntero a una cadena de caracteres anchos terminada en NULL para la contraseña. Para obtener información sobre cómo proteger la información de contraseñas, consulte Control de contraseñas.
Valor devuelto
El valor devuelto es un HRESULT. Un valor de S_OK indica que el nombre de la cuenta y la contraseña se establecieron correctamente. Cualquier otro valor indica una condición de error.
Si se produce un error en la función, a continuación se enumeran algunos de los posibles valores devueltos.
| Código o valor devuelto | Descripción |
|---|---|
|
Se denegó el acceso. Este error se devuelve si el autor de la llamada no era miembro del grupo Administradores. Este error también se devuelve si el parámetro pwszAccount no era NULL que indica una cuenta con nombre no la cuenta del sistema local y el parámetro pwszPassword era incorrecto para la cuenta especificada en el parámetro pwszAccount . |
|
Los datos no son válidos. Este error se devuelve si el parámetro pwszPassword era NULL o la longitud de la cadena de parámetro pwszPassword era demasiado larga. |
|
No se puede establecer la existencia de la cuenta especificada. Este error se devuelve si el parámetro pwszAccount no era NULL que indica una cuenta con nombre no la cuenta del sistema local y no se encontró el parámetro pwszAccount . |
Comentarios
SetNetScheduleAccountInformation suplanta al autor de la llamada. Solo los miembros del grupo de administradores locales en el equipo en el que se establece la información de la cuenta de programación pueden ejecutar correctamente esta función. Tenga en cuenta que no se permiten contraseñas NULL .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista, Windows XP con SP1 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | atacct.h |
| Library | Mstask.lib |
| Archivo DLL | Mstask.dll |