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 |
|---|---|
|
A tarefa não existe. |
|
O parâmetro pwszName não é válido. |
|
Falha na alocação de memória. |
|
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 |