Поделиться через

Метод TaskService.Connect

  • Статья

Для создания скриптов подключается к удаленному компьютеру и связывает все последующие вызовы этого интерфейса с удаленным сеансом. Если параметр serverName пуст, этот метод будет выполняться на локальном компьютере. Если userId не указан, используется текущий токен.

Синтаксис

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

Параметры

serverName [in, необязательный]

Имя компьютера, к которому требуется подключиться. Если параметр serverName пуст, этот метод будет выполняться на локальном компьютере.

user [in, optional]

Имя пользователя, используемое во время подключения к компьютеру. Если пользователь не указан, используется текущий токен.

domain [in, optional]

Домен пользователя, указанного в параметре user .

password [in, optional]

Пароль, используемый для подключения к компьютеру. Если имя пользователя и пароль не указаны, используется текущий маркер.

Возвращаемое значение

Этот метод не возвращает значение.

Комментарии

Метод TaskService.Connect должен вызываться перед вызовом любого из других методов TaskService .

Если метод Connect завершается сбоем, можно собрать идентификатор ошибки, чтобы найти ее смысл. В следующей таблице перечислены идентификаторы ошибок и их описания.

Идентификатор ошибки Описание
0x80070005 Доступ к службе планировщика задач запрещен.
0x80041315 Служба планировщика задач не запущена.
0x8007000e Приложение не имеет достаточно памяти для завершения операции, либо пользователь, пароль или домен имеет по крайней мере одно значение NULL и одно значение, отличное от NULL.
53 Эта ошибка возвращается в следующих ситуациях:
  • Имя компьютера, указанное в параметре serverName , не существует.
  • При попытке подключиться к компьютеру Windows Server 2003 или Windows XP, если на удаленном компьютере не включено исключение брандмауэра "Общий доступ к файлам и принтерам" или служба удаленного реестра не запущена.
  • При попытке подключиться к компьютеру Windows Vista, если на удаленном компьютере не включено исключение брандмауэра "Управление удаленными задачами" и брандмауэр "Общий доступ к файлам и принтерам" или служба удаленного реестра не запущена.
50 Параметры пользователя, пароля или домена нельзя указать при подключении к удаленному компьютеру Windows XP или Windows Server 2003 с компьютера Windows Vista.

Если вы хотите подключиться к удаленному компьютеру Windows Vista из Windows Vista, необходимо разрешить исключение брандмауэра удаленного управления запланированными задачами на удаленном компьютере. Чтобы разрешить это исключение, щелкните Пуск, панель управления, Безопасность, Разрешить программу через брандмауэр Windows, а затем установите флажок Управление удаленными запланированными задачами проверка. Затем нажмите кнопку ОК в диалоговом окне Параметры брандмауэра Windows.

Если вы подключаетесь к удаленному компьютеру Windows XP или Windows Server 2003 с компьютера Windows Vista, необходимо разрешить на удаленном компьютере исключение брандмауэра "Общий доступ к файлам и принтерам". Чтобы разрешить это исключение, нажмите кнопку Пуск, панель управления, дважды щелкните брандмауэр Windows, перейдите на вкладку Исключения, а затем выберите исключение брандмауэра "Общий доступ к файлам и принтерам". Затем нажмите кнопку ОК в диалоговом окне Брандмауэр Windows. Служба удаленного реестра также должна быть запущена на удаленном компьютере.

Требования

Требование Значение
Минимальная версия клиента
 Windows Vista [только классические приложения]
Минимальная версия сервера
 Windows Server 2008 [только классические приложения]
Библиотека типов
Taskschd.tlb
DLL
Taskschd.dll