Метод 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
Header mstask.h
Библиотека Mstask.lib
DLL Mstask.dll
Распространяемые компоненты Internet Обозреватель 4.0 или более поздней версии в Windows NT 4.0 и Windows 95

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

GetApplicationName

ITask