iTaskScheduler::SetTargetComputer 方法 (mstask.h)

[[此 API 可能在操作系统或产品的后续版本中更改或不可用。 请改用 任务计划程序 2.0 接口 。] ]

SetTargetComputer 方法选择 ITaskScheduler 接口操作的计算机,从而允许远程任务管理和枚举。

语法

HRESULT SetTargetComputer(
  [in] LPCWSTR pwszComputer
);

参数

[in] pwszComputer

指向以 null 结尾的宽字符串的指针,该字符串指定 ITaskScheduler 接口的当前实例的目标计算机名称。 以通用命名约定 (UNC) 格式指定目标计算机名称。 若要指示本地计算机,请将此值设置为 NULL 或本地计算机的 UNC 名称。

注意 指定远程计算机名称时,请在计算机名称前使用两个反斜杠 (\\) 个字符。 例如,使用“\\ComputerName”而不是“ComputerName”。
 

返回值

SetTargetComputer 方法返回以下值之一。

返回代码 说明
S_OK
方法成功。
SCHED_E_SERVICE_NOT_INSTALLED
任务计划程序服务未安装在目标计算机上。
E_ACCESS_DENIED
用户无权访问远程计算机。
E_INVALIDARG
pwszComputer 参数无效。
E_OUTOFMEMORY
发生内存分配失败。

注解

对于 Windows Server 2003(Windows XP 计算机)在 Windows Vista 计算机上创建、监视或控制任务,应在 Windows Vista 计算机上完成以下操作,调用 ITaskScheduler::SetTargetComputer 方法的用户必须是远程 Windows Vista 计算机上的 Administrators 组的成员。

在 Windows 防火墙中启用“共享文件和打印机”例外

  1. 单击“开始”,然后单击“控制面板”。
  2. 在“控制面板”中,单击“经典视图”,然后双击“Windows 防火墙”图标。
  3. 在“Windows 防火墙”窗口中,单击“例外”选项卡,然后选择“文件和打印机共享例外检查框。

启用“远程注册表”服务

  • 打开命令提示符窗口并输入以下命令: net start “远程注册表”

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 mstask.h
Library Mstask.lib
DLL Mstask.dll

另请参阅

ITaskScheduler