Método SetPriority da classe Win32_Process

O método de classe WMISetPriority tenta alterar a prioridade de execução do processo.

Este tópico usa a sintaxe MOF (Managed Object Format). Para obter mais informações sobre como usar esse método, consulte Chamando um método.

Sintaxe

uint32 SetPriority(
  [in] sint32 Priority
);

Parâmetros

Prioridade [in]

Nova classe de prioridade para o processo. Observe que esses valores são diferentes daqueles explicitamente declarados na propriedade Priority de Win32_Process.

Ocioso (64)

Especificado para um processo com threads que são executados somente quando o sistema está ocioso. Os threads do processo são precedidos pelos threads de um processo executado em uma classe de prioridade mais alta, por exemplo, um protetor de tela. A classe de prioridade ociosa é herdada por processos filho.

Abaixo do normal (16384)

Indica um processo que tem prioridade acima de IDLE_PRIORITY_CLASS, mas abaixo NORMAL_PRIORITY_CLASS.

Normal (32)

Especificado para um processo sem necessidades especiais de agendamento.

Acima do normal (32768)

Indica um processo que tem prioridade acima de NORMAL_PRIORITY_CLASS, mas abaixo HIGH_PRIORITY_CLASS.

Alta Prioridade (128)

Especificado para um processo que executa tarefas críticas de tempo que devem ser executadas imediatamente. Os threads do processo capturam os threads de processos da classe de prioridade normal ou ociosa. Um exemplo é a Lista de Tarefas, que deve responder rapidamente quando chamada pelo usuário, independentemente da carga no sistema operacional. Use um cuidado extremo ao usar a classe de alta prioridade, pois um aplicativo de classe de alta prioridade pode usar quase todo o tempo de CPU disponível.

Tempo real (256)

Especificado para um processo que tem a prioridade mais alta possível. Os threads do processo preempõem os threads de todos os outros processos, incluindo processos do sistema operacional que executam tarefas importantes. Por exemplo, um processo em tempo real executado por mais de um intervalo muito breve pode fazer com que os caches de disco não liberem ou um mouse não responda.

Valor retornado

Retorna um dos valores listados na lista a seguir ou um valor diferente para indicar um erro. Para obter códigos de erro adicionais, consulte Constantes de erro WMI ou WbemErrorEnum. Para obter valores gerais de HRESULT , consulte Códigos de erro do sistema.

Conclusão bem-sucedida (0)

Acesso negado (2)

Privilégio insuficiente (3)

Falha desconhecida (8)

Caminho não encontrado (9)

Parâmetro inválido (21)

Outro (22 4294967295)

Comentários

Para definir a prioridade como Realtime, o chamador deve ter SeIncreaseBasePriorityPrivilege (SE_INC_BASE_PRIORITY_PRIVILEGE). Sem esse privilégio, a prioridade mais alta pode ser definida como alta prioridade.

Exemplos

O exemplo Modificar a prioridade de um processo em execução do VBScript altera a prioridade de uma instância em execução do Notepad.exe de Normal para Acima do Normal.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Confira também

Classes do sistema operacional

Win32_Process