Método ITaskScheduler::Activate (mstask.h)

[[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 .] ]

O método Activate retorna uma interface ativa para um item de trabalho especificado.

Sintaxe

HRESULT Activate(
  [in]  LPCWSTR  pwszName,
  [in]  REFIID   riid,
  [out] IUnknown **ppUnk
);

Parâmetros

[in] pwszName

Uma cadeia de caracteres terminada em nulo que especifica o nome do item de trabalho a ser ativado.

[in] riid

Um identificador que identifica a interface que está sendo solicitada. A única interface com suporte no momento, ITask, tem o identificador IID_ITask.

[out] ppUnk

Um ponteiro para um ponteiro de interface que recebe o endereço da interface solicitada.

Retornar valor

Quando esse método é bem-sucedido, S_OK é retornado.

Se o método falhar, um dos seguintes códigos de erro poderá ser retornado.

Código de retorno	Descrição
COR_E_FILENOTFOUND	A tarefa não existe.
E_INVALIDARG	O parâmetro pwszName não é válido.
E_OUTOFMEMORY	Falha na alocação de memória.
SCHED_E_UNKNOWN_OBJECT_VERSION	A versão do objeto de tarefa não tem suporte ou é inválida.

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

ITaskScheduler