Método ITask::SetWorkingDirectory (mstask.h)

  • Artículo

[[Esta API puede modificarse o no estar disponible en versiones posteriores del sistema operativo o del producto. Use las interfaces del Programador de tareas 2.0 en su lugar. ]

Este método establece el directorio de trabajo de la tarea.

Sintaxis

HRESULT SetWorkingDirectory(
  [in] LPCWSTR pwszWorkingDirectory
);

Parámetros

[in] pwszWorkingDirectory

Cadena terminada en null que contiene una ruta de acceso de directorio al directorio de trabajo de la tarea.

La aplicación comienza con este directorio como directorio de trabajo actual. Para borrar el directorio, establezca pwszWorkingDirectory en L"". Si el directorio de trabajo se establece en L"", cuando se ejecuta la aplicación, el directorio actual será el directorio en el que reside el ejecutable del servicio de programador de tareas, Mstask.exe.

Valor devuelto

El método SetWorkingDirectory devuelve uno de los valores siguientes.

Código devuelto Descripción
S_OK
 La operación se realizó correctamente.
E_INVALIDARG
 Los argumentos no son válidos.
E_OUTOFMEMORY
 No hay suficiente memoria disponible.

Comentarios

Después de establecer el directorio de trabajo de una tarea, asegúrese de llamar a IPersistFile::Save para guardar el objeto de tarea modificado en el disco.

Ejemplos

Para obtener un ejemplo de cómo establecer el directorio de trabajo de una tarea, vea Ejemplo de código de C/C++: Establecer directorio de trabajo.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mstask.h
Library Mstask.lib
Archivo DLL Mstask.dll
Redistribuible Internet Explorer 4.0 o posterior en Windows NT 4.0 y Windows 95

Consulte también

GetWorkingDirectory

ITask