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

Метод ITaskService::Connect (taskschd.h)

  • Статья

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

Синтаксис

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

Параметры

[in, optional] serverName

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

[in, optional] user

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

[in, optional] domain

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

[in, optional] password

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

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

Этот метод может возвращать одно из этих значений.

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

Комментарии

Метод ITaskService::Connect следует вызвать перед вызовом любого из других методов ITaskService .

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

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

ПримечаниеITaskService::Connect может возвращать ошибку SCHED_E_INVALIDVALUE при чтении определения задачи, если схема удаленной задачи не поддерживается текущим компьютером. Чтобы проверить самую высокую версию схемы, поддерживаемую текущим компьютером, проверка свойство ITaskService::HighestVersion.
 

Требования

   
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header taskschd.h
Библиотека Taskschd.lib
DLL Taskschd.dll

См. также раздел

ITaskService

ITaskService::HighestVersion