iTask::SetApplicationName 方法 (mstask.h)

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

此方法将特定应用程序分配给当前 任务

语法

HRESULT SetApplicationName(
  [in] LPCWSTR pwszApplicationName
);

参数

[in] pwszApplicationName

一个以 null 结尾的字符串,其中包含将与任务关联的应用程序的名称。 使用空字符串清除应用程序名称。

返回值

SetApplicationName 方法返回以下值之一。

返回代码 说明
S_OK
操作成功。
E_INVALIDARG
参数无效。
E_OUTOFMEMORY
内存不足。

注解

如果未指定应用程序的路径,任务计划程序将搜索环境路径以查找正确的路径。 如果应用程序名称指定了程序,则名称应使用 .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 或更高版本

另请参阅

GetApplicationName

ITask