Método ITaskSettings::get_Priority (taskschd.h)

  • Artigo

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

Essa propriedade é leitura/gravação.

Sintaxe

HRESULT get_Priority(
  int *pPriority
);

Parâmetros

pPriority

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 o manipulador COM, a caixa de mensagem e as ações de tarefa de email. Para obter mais informações sobre os valores classe de prioridade e nível de prioridade, consulte Prioridades de agendamento. 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
 

Ao ler ou gravar XML para uma tarefa, essa configuração é especificada no elemento Priority (settingsType) do esquema do 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