Метод 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