Método ITaskSettings::get_Priority (taskschd.h)
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 |