Método IShellTaskScheduler::AddTask (shobjidl_core.h)

Artigo
03/05/2024

Adiciona uma tarefa à fila em segundo plano do agendador.

Sintaxe

HRESULT AddTask(
  [in] IRunnableTask  *prt,
  [in] REFTASKOWNERID rtoid,
  [in] DWORD_PTR      lParam,
  [in] DWORD          dwPriority
);

Parâmetros

[in] prt

Tipo: IRunnableTask*

Um ponteiro para uma instância de uma interface IRunnableTask que representa a tarefa a ser adicionada à fila.

[in] rtoid

Tipo: REFTASKOWNERID

Um GUID que identifica o proprietário da tarefa. Essas informações podem ser usadas para agrupar tarefas para contagem ou remoção posteriores por proprietário.

[in] lParam

Tipo: DWORD_PTR

Um ponteiro para um valor DWORD definido pelo usuário que permite que a tarefa seja identificada dentro das tarefas pertencentes a rtoid. Isso é usado para identificar tarefas individuais ou subagrupá-las, por exemplo, associar a tarefa a um item específico, como um item em um ListView. Esse parâmetro pode ser zero.

[in] dwPriority

Tipo: DWORD

Um dos valores a seguir atribuindo a prioridade da tarefa. A resposta a essa prioridade depende da cooperação das outras tarefas que estão sendo executadas. Novas tarefas são inseridas na fila na ordem de prioridade. Se uma tarefa de baixa prioridade estiver atualmente em execução quando uma tarefa de prioridade mais alta for adicionada, o agendador tentará suspender a tarefa em execução. Essa tarefa de prioridade mais baixa é retomada quando as tarefas de prioridade mais alta são concluídas.

ITSAT_DEFAULT_PRIORITY

Aceite a prioridade padrão atribuída à tarefa pelo agendador.

ITSAT_MAX_PRIORITY

Prioridade alta.

ITSAT_MIN_PRIORITY

Baixa prioridade.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

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	shobjidl_core.h (inclua Shobjidl.h)
DLL	Shell32.dll (versão 5.0 ou posterior)

Compartilhar via