Edit

TaskService.Connect method

  • Article

For scripting, connects to a remote machine and associates all subsequent calls on this interface with a remote session. If the serverName parameter is empty, then this method will execute on the local computer. If the userId is not specified, then the current token is used.

Syntax

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

Parameters

serverName [in, optional]

The name of the computer that you want to connect to. If the serverName parameter is empty, then this method will execute on the local computer.

user [in, optional]

The user name that is used during the connection to the computer. If the user is not specified, then the current token is used.

domain [in, optional]

The domain of the user specified in the user parameter.

password [in, optional]

The password that is used to connect to the computer. If the user name and password are not specified, then the current token is used.

Return value

This method does not return a value.

Remarks

The TaskService.Connect method should be called before calling any of the other TaskService methods.

If the Connect method fails, you can collect the error identifier to find the meaning of the error. The following table lists the error identifiers and their descriptions.

Error Identifier Description
0x80070005 Access is denied to connect to the Task Scheduler service.
0x80041315 The Task Scheduler service is not running.
0x8007000e The application does not have enough memory to complete the operation or the user, password, or domain has at least one null and one non-null value.
53 This error is returned in the following situations:
  • The computer name specified in the serverName parameter does not exist.
  • When you are trying to connect to a Windows Server 2003 or Windows XP computer, and the remote computer does not have the File and Printer Sharing firewall exception enabled or the Remote Registry service is not running.
  • When you are trying to connect to a Windows Vista computer, and the remote computer does not have the Remote Scheduled Tasks Management firewall exception enabled and the File and Printer Sharing firewall exception enabled, or the Remote Registry service is not running.
50 The user, password, or domain parameters cannot be specified when connecting to a remote Windows XP or Windows Server 2003 computer from a Windows Vista computer.

If you are to connecting to a remote Windows Vista computer from a Windows Vista, you need to allow the Remote Scheduled Tasks Management firewall exception on the remote computer. To allow this exception click Start, Control Panel, Security, Allow a program through Windows Firewall, and then select the Remote Scheduled Tasks Management check box. Then click the Ok button in the Windows Firewall Settings dialog box.

If you are connecting to a remote Windows XP or Windows Server 2003 computer from a Windows Vista computer, you need to allow the File and Printer Sharing firewall exception on the remote computer. To allow this exception click Start, Control Panel, double-click Windows Firewall, select the Exceptions tab, and then select the File and Printer Sharing firewall exception. Then click the OK button in the Windows Firewall dialog box. The Remote Registry service must also be running on the remote computer.

Requirements

Requirement Value
Minimum supported client
 Windows Vista [desktop apps only]
Minimum supported server
 Windows Server 2008 [desktop apps only]
Type library
Taskschd.tlb
DLL
Taskschd.dll