Método ITaskService::Connect (taskschd.h)

Se conecta a un equipo remoto y asocia todas las llamadas posteriores en esta interfaz con una sesión remota. Si el parámetro serverName está vacío, este método se ejecutará en el equipo local. Si no se especifica el usuario , se usa el token actual.

Sintaxis

HRESULT Connect(
  [in, optional] VARIANT serverName,
  [in, optional] VARIANT user,
  [in, optional] VARIANT domain,
  [in, optional] VARIANT password
);

Parámetros

[in, optional] serverName

Nombre del equipo al que desea conectarse. Si el parámetro serverName está vacío, este método se ejecutará en el equipo local.

[in, optional] user

Nombre de usuario que se usa durante la conexión al equipo. Si no se especifica el usuario , se usa el token actual.

[in, optional] domain

Dominio del usuario especificado en el parámetro user .

[in, optional] password

Contraseña que se usa para conectarse al equipo. Si no se especifican el nombre de usuario y la contraseña, se usa el token actual.

Valor devuelto

Este método puede devolver uno de estos valores.

Código o valor devuelto	Descripción
S_OK 0	La operación se ha completado correctamente.
E_ACCESS_DENIED 0x80070005	Se deniega el acceso para conectarse al servicio Programador de tareas.
SCHED_E_SERVICE_NOT_RUNNING 0x80041315	El servicio Programador de tareas no se está ejecutando.
E_OUTOFMEMORY 0x8007000e	La aplicación no tiene suficiente memoria para completar la operación o el usuario, la contraseña o el dominio tiene al menos un valor NULL y un valor distinto de NULL.
ERROR_BAD_NETPATH 53	Este error se devuelve en las situaciones siguientes: El nombre de equipo especificado en el parámetro serverName no existe. Cuando intenta conectarse a un equipo Con Windows Server 2003 o Windows XP, y el equipo remoto no tiene habilitada la excepción firewall de uso compartido de archivos e impresoras o el servicio registro remoto no se está ejecutando. Cuando intenta conectarse a un equipo con Windows Vista, y el equipo remoto no tiene habilitada la excepción de firewall de administración de tareas programadas remotas y la excepción de firewall de uso compartido de archivos e impresoras habilitada, o el servicio registro remoto no se está ejecutando.
ERROR_NOT_SUPPORTED 50	No se pueden especificar los parámetros de usuario, contraseña o dominio al conectarse a un equipo remoto de Windows XP o Windows Server 2003 desde un equipo con Windows Vista.

Comentarios

Se debe llamar al método ITaskService::Connect antes de llamar a cualquiera de los otros métodos ITaskService .

Si va a conectarse a un equipo remoto de Windows Vista desde Windows Vista, debe permitir la excepción de firewall de administración de tareas programadas remotas en el equipo remoto. Para permitir esta excepción, haga clic en Inicio, Panel de control, Seguridad, Permitir un programa a través del Firewall de Windows y, a continuación, active la casilla Administración remota de tareas programadas. A continuación, haga clic en el botón Aceptar en el cuadro de diálogo Configuración del Firewall de Windows.

Si va a conectarse a un equipo remoto equipado con Windows XP o Windows Server 2003 desde un equipo equipado con Windows Vista, necesita permitir la excepción de firewall Compartir archivos e impresoras en el equipo remoto. Para permitir esta excepción, haga clic en Inicio, Panel de control, haga doble clic en Firewall de Windows, seleccione la pestaña Excepciones y, a continuación, seleccione la excepción Firewall de uso compartido de impresoras y archivos. A continuación, haga clic en el botón Aceptar en el cuadro de diálogo Firewall de Windows. El servicio Registro remoto también debe ejecutarse en el equipo remoto.

NotaITaskService::Connect puede devolver un error SCHED_E_INVALIDVALUE al leer la definición de la tarea si el esquema de la tarea remota no es compatible con la máquina actual. Para comprobar la versión de esquema más alta compatible con la máquina actual, compruebe la propiedad ITaskService::HighestVersion .

 

Requisitos

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	taskschd.h
Library	Taskschd.lib
Archivo DLL	Taskschd.dll

Consulte también

ITaskService

ITaskService::HighestVersion