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

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

Esse método define os parâmetros de linha de comando para a tarefa.

Sintaxe

HRESULT SetParameters(
  [in] LPCWSTR pwszParameters
);

Parâmetros

[in] pwszParameters

Uma cadeia de caracteres terminada em nulo que contém parâmetros de tarefa. Esses parâmetros são passados como argumentos de linha de comando para o aplicativo que a tarefa executará. Para limpar a propriedade de parâmetro de linha de comando, defina pwszParameters como L"".

Retornar valor

O método SetParameters 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

Se a tarefa tiver um aplicativo associado a ela, os parâmetros de tarefa definidos por esse método serão ignorados.

Depois de definir os parâmetros da tarefa, chame IPersistFile::Save para salvar o objeto de tarefa modificado no disco.

Exemplos

Para obter um exemplo de como definir parâmetros, consulte Exemplo de código C/C++: definindo parâmetros de tarefa.

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

Itask