Share via

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

  • Artigo

[[Essa API pode estar alterada ou indisponível em versões subsequentes do sistema operacional ou do produto. Em vez disso, use as Interfaces do Agendador de Tarefas 2.0 .] ]

Esse método define o diretório de trabalho para a tarefa.

Sintaxe

HRESULT SetWorkingDirectory(
  [in] LPCWSTR pwszWorkingDirectory
);

Parâmetros

[in] pwszWorkingDirectory

Uma cadeia de caracteres terminada em nulo que contém um caminho de diretório para o diretório de trabalho da tarefa.

O aplicativo começa com esse diretório como o diretório de trabalho atual. Para limpar o diretório, defina pwszWorkingDirectory como L"". Se o diretório de trabalho estiver definido como L", quando o aplicativo for executado, o diretório atual será o diretório no qual o executável do serviço do agendador de tarefas, Mstask.exe, residirá.

Retornar valor

O método SetWorkingDirectory retorna um dos valores a seguir.

Código de retorno Descrição
S_OK
 A operação foi bem-sucedida.
E_INVALIDARG
 Os argumentos não são válidos.
E_OUTOFMEMORY
 Não existe memória suficiente.

Comentários

Depois de definir o diretório de trabalho de uma tarefa, chame IPersistFile::Save para salvar o objeto de tarefa modificado no disco.

Exemplos

Para obter um exemplo de como definir o diretório de trabalho de uma tarefa, consulte Exemplo de código C/C++: configurando o diretório de trabalho.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mstask.h
Biblioteca Mstask.lib
DLL Mstask.dll
Redistribuível Internet Explorer 4.0 ou posterior no Windows NT 4.0 e Windows 95

Confira também

GetWorkingDirectory

Itask