Compartilhar via


Método ITask::GetPriority (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 .] ]

Esse método recupera a prioridade da tarefa.

Sintaxe

HRESULT GetPriority(
  [out] DWORD *pdwPriority
);

Parâmetros

[out] pdwPriority

Um ponteiro para um DWORD que contém a prioridade da tarefa atual. O valor de prioridade determina a frequência e o comprimento das fatias de tempo de um processo. Isso se aplica somente aos sistemas operacionais Windows Server 2003, Windows XP e Windows 2000. Ele é obtido da classe de prioridade CreateProcess e pode ser um dos seguintes sinalizadores (em ordem decrescente de prioridade de agendamento de thread):

  • REALTIME_PRIORITY_CLASS
  • HIGH_PRIORITY_CLASS
  • NORMAL_PRIORITY_CLASS
  • IDLE_PRIORITY_CLASS

Retornar valor

O método GetPriority retorna um dos valores a seguir.

Código de retorno Descrição
S_OK
A operação foi bem-sucedida.
E_INVALIDARG
Os argumentos não são válidos.
E_OUTOFMEMORY
Não existe memória suficiente.

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 mstask.h
Biblioteca Mstask.lib
DLL Mstask.dll

Confira também

Itask

Setpriority