Método TaskService.Connect

Para el scripting, se conecta a una máquina remota 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 userId, se usa el token actual.

Sintaxis

TaskService.Connect( _
  [ ByVal serverName ], _
  [ ByVal user ], _
  [ ByVal domain ], _
  [ ByVal password ] _
)

Parámetros

serverName [in, opcional]

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

usuario [in, opcional]

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

dominio [in, opcional]

Dominio del usuario especificado en el parámetro user .

contraseña [in, opcional]

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 no devuelve ningún valor.

Comentarios

Se debe llamar al método TaskService.Connect antes de llamar a cualquiera de los demás métodos taskService .

Si se produce un error en el método Connect, puede recopilar el identificador de error para encontrar el significado del error. En la tabla siguiente se enumeran los identificadores de error y sus descripciones.

Identificador de error	Descripción
0x80070005	Se deniega el acceso para conectarse al servicio Programador de tareas.
0x80041315	El servicio Programador de tareas no se está ejecutando.
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.
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.
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.

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, Dejar pasar a un programa a través de 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 de 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 ficha Excepciones y, a continuación, seleccione la excepción de firewall Compartir archivos e impresoras. 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.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Biblioteca de tipos	Taskschd.tlb
Archivo DLL	Taskschd.dll