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.

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

Confira também

IScheduledWorkItem

ITaskScheduler

ITaskScheduler::NewWorkItem