Método ITaskSettings::p ut_Priority (taskschd.h)

  • Artigo

Obtém ou define o nível de prioridade da tarefa.

Essa propriedade é leitura/gravação.

Sintaxe

HRESULT put_Priority(
  int priority
);

Parâmetros

priority

Valor retornado

Nenhum

Comentários

O nível de prioridade 0 é a prioridade mais alta e o nível de prioridade 10 é a prioridade mais baixa. O valor padrão é 7. Os níveis de prioridade 7 e 8 são usados para tarefas em segundo plano e os níveis de prioridade 4, 5 e 6 são usados para tarefas interativas.

A ação da tarefa é iniciada em um processo com uma prioridade baseada em um valor de Classe de Prioridade. Um valor de Nível de Prioridade (prioridade de thread) é usado para ações de tarefa com manipulador, caixa de mensagem e email. Para obter mais informações sobre os valores classe de prioridade e nível de prioridade, consulte Prioridades de agendamento. Esse valor também afeta a prioridade de memória (consulte MEMORY_PRIORITY_INFORMATION). A tabela a seguir lista os valores possíveis para o parâmetro de prioridade e os valores de Classe de Prioridade e Nível de Prioridade correspondentes.

Prioridade da tarefa Classe Priority Nível de prioridade
0 REALTIME_PRIORITY_CLASS THREAD_PRIORITY_TIME_CRITICAL
1 HIGH_PRIORITY_CLASS THREAD_PRIORITY_HIGHEST
2 ABOVE_NORMAL_PRIORITY_CLASS THREAD_PRIORITY_ABOVE_NORMAL
3 ABOVE_NORMAL_PRIORITY_CLASS THREAD_PRIORITY_ABOVE_NORMAL
4 NORMAL_PRIORITY_CLASS THREAD_PRIORITY_NORMAL
5 NORMAL_PRIORITY_CLASS THREAD_PRIORITY_NORMAL
6 NORMAL_PRIORITY_CLASS THREAD_PRIORITY_NORMAL
7 BELOW_NORMAL_PRIORITY_CLASS THREAD_PRIORITY_BELOW_NORMAL
8 BELOW_NORMAL_PRIORITY_CLASS THREAD_PRIORITY_BELOW_NORMAL
9 IDLE_PRIORITY_CLASS THREAD_PRIORITY_LOWEST
10 IDLE_PRIORITY_CLASS THREAD_PRIORITY_IDLE
  A prioridade da tarefa 4 corresponde à prioridade de memória 'MEMORY_PRIORITY_NORMAL(5)', 5 a 'MEMORY_PRIORITY_BELOW_NORMAL(4)' e 6 a 'MEMORY_PRIORITY_MEDIUM(3)'.

Ao ler ou gravar XML para uma tarefa, essa configuração é especificada no elemento Priority (settingsType) do esquema agendador de tarefas.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho taskschd.h
Biblioteca Taskschd.lib
DLL Taskschd.dll

Confira também

ITaskSettings