[[此 API 可能在操作系统或产品的后续版本中更改或不可用。 请改用 任务计划程序 2.0 接口 。] ]
此方法将特定应用程序分配给当前 任务。
语法
HRESULT SetApplicationName(
  [in] LPCWSTR pwszApplicationName
);
参数
[in] pwszApplicationName
一个以 null 结尾的字符串,其中包含将与任务关联的应用程序的名称。 使用空字符串清除应用程序名称。
返回值
SetApplicationName 方法返回以下值之一。
| 返回代码 | 说明 | 
|---|---|
| 
 | 操作成功。 | 
| 
 | 参数无效。 | 
| 
 | 内存不足。 | 
注解
如果未指定应用程序的路径,任务计划程序将搜索环境路径以查找正确的路径。 如果应用程序名称指定了程序,则名称应使用 .exe 扩展,以确保任务计划程序用户界面正确显示应用程序的图标。
调用 SetApplicationName 后,请确保调用 IPersistFile::Save 将修改后的任务保存到磁盘。
示例
有关如何设置应用程序名称的示例,请参阅 C/C++ 代码示例:设置应用程序名称。
要求
| 要求 | 值 | 
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] | 
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] | 
| 目标平台 | Windows | 
| 标头 | mstask.h | 
| Library | Mstask.lib | 
| DLL | Mstask.dll | 
| 可再发行组件 | Windows NT 4.0 和 Windows 95 上的 Internet Explorer 4.0 或更高版本 |