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