Método ITaskScheduler::AddWorkItem (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 .] ]
O método AddWorkItem adiciona uma tarefa ao agendamento de tarefas.
Sintaxe
HRESULT AddWorkItem(
[in] LPCWSTR pwszTaskName,
[in] IScheduledWorkItem *pWorkItem
);
Parâmetros
[in] pwszTaskName
Uma cadeia de caracteres terminada em nulo que especifica o nome da tarefa a ser adicionada. O nome da tarefa deve estar em conformidade com Windows NT convenções de nomenclatura de arquivo, mas não pode incluir barras invertidas porque o aninhamento dentro do objeto de pasta de tarefa não é permitido.
[in] pWorkItem
Um ponteiro para a tarefa a ser adicionada ao agendamento.
Retornar valor
O método AddWorkItem retorna um dos valores a seguir.
| Código de retorno | Descrição |
|---|---|
|
A operação foi bem-sucedida. |
|
Uma tarefa com o nome especificado já existe. O valor retornado real é HRESULT_FROM_WIN32(ERROR_FILE_EXISTS). |
|
Um ou mais dos argumentos não são válidos. |
|
Não há memória disponível suficiente para concluir a operação. |
Comentários
O agendador de tarefas fornece dois métodos para adicionar itens de trabalho: NewWorkItem e AddWorkItem. Desses métodos, cada um tem sua vantagem específica. AddWorkItem impede colisões de nomenclatura, mas também requer duas operações de gravação de disco por chamada. Uma operação de gravação é executada quando a chamada para AddWorkItem cria um objeto de item de trabalho vazio no disco, seguido por outra operação de gravação quando IPersistFile::Save é chamado.
NewWorkItem não impede colisões de nomenclatura, mas requer apenas uma operação de gravação de disco quando IPersistFile::Save é chamado. Embora NewWorkItem seja mais eficiente com operações de gravação de disco, o aplicativo corre o risco de outro aplicativo criar um item de trabalho com o mesmo nome antes da chamada para IPersistFile::Save ser feita.
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 |