Поделиться через


Метод ITask::SetWorkingDirectory (mstask.h)

[[Этот API может быть изменен или недоступен в последующих версиях операционной системы или продукта. Вместо этого используйте интерфейсы планировщика задач 2.0 .] ]

Этот метод задает рабочий каталог для задачи.

Синтаксис

HRESULT SetWorkingDirectory(
  [in] LPCWSTR pwszWorkingDirectory
);

Параметры

[in] pwszWorkingDirectory

Строка, завершающаяся значением NULL, содержащая путь к рабочему каталогу для задачи.

Приложение начинается с этого каталога в качестве текущего рабочего каталога. Чтобы очистить каталог, задайте для параметра pwszWorkingDirectory значение L"". Если для рабочего каталога задано значение L"", то при запуске приложения текущим каталогом будет каталог, в котором находится исполняемый файл службы планировщика задач, Mstask.exe.

Возвращаемое значение

Метод SetWorkingDirectory возвращает одно из следующих значений.

Код возврата Описание
S_OK
Операция выполнена успешно.
E_INVALIDARG
Недопустимые аргументы.
E_OUTOFMEMORY
Недостаточно памяти.

Комментарии

Задав рабочий каталог задачи, обязательно вызовите IPersistFile::Save , чтобы сохранить измененный объект задачи на диске.

Примеры

Пример задания рабочего каталога задачи см. в разделе C/C++ Code Example: Setting Working Directory.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header mstask.h
Библиотека Mstask.lib
DLL Mstask.dll
Распространяемые компоненты Internet Обозреватель 4.0 или более поздней версии в Windows NT 4.0 и Windows 95

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

GetWorkingDirectory

ITask