Compartir a través de


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
E_ACCESSDENIED
0x080070005
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 .
HRESULT_FROM_WIN32(ERROR_INVALID_DATA)
0x08007000d
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.
SCHED_E_ACCOUNT_NAME_NOT_FOUND
0x80041310
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

Consulte también

GetNetScheduleAccountInformation