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