iTask::SetApplicationName 方法 (mstask.h)
[[此 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 或更高版本 |