Método SetPriority de la clase Win32_Process

El método de clase WMISetPriority intenta cambiar la prioridad de ejecución del proceso.

En este tema se usa la sintaxis de Managed Object Format (MOF). Para obtener más información sobre el uso de este método, vea Llamar a un método.

Sintaxis

uint32 SetPriority(
  [in] sint32 Priority
);

Parámetros

Prioridad [in]

Nueva clase de prioridad para el proceso. Tenga en cuenta que estos valores son diferentes de los indicados explícitamente en la propiedad Priority de Win32_Process.

Inactivo (64)

Se especifica para un proceso con subprocesos que solo se ejecutan cuando el sistema está inactivo. Los subprocesos del proceso se adelantan a los subprocesos de un proceso que se ejecutan en una clase de prioridad más alta, por ejemplo, un protector de pantalla. Los procesos secundarios heredan la clase de prioridad inactiva.

Por debajo de lo normal (16384)

Indica un proceso que tiene prioridad por encima de IDLE_PRIORITY_CLASS, pero por debajo de NORMAL_PRIORITY_CLASS.

Normal (32)

Se especifica para un proceso sin necesidad de programación especial.

Por encima de normal (32768)

Indica un proceso que tiene prioridad por encima de NORMAL_PRIORITY_CLASS, pero por debajo de HIGH_PRIORITY_CLASS.

Prioridad alta (128)

Se especifica para un proceso que realiza tareas críticas para el tiempo que se deben ejecutar inmediatamente. Los subprocesos del proceso tienen prioridad sobre los subprocesos de aquellos procesos de clase de prioridad normal o inactiva. Un ejemplo es la lista de tareas, que debe responder rápidamente cuando lo llame el usuario, independientemente de la carga en el sistema operativo. Use un cuidado extremo al usar la clase de prioridad alta, ya que una aplicación de clase de prioridad alta puede usar casi todo el tiempo de CPU disponible.

Tiempo real (256)

Se especifica para un proceso que tiene la prioridad más alta posible. Los subprocesos del proceso reemplazan los subprocesos de todos los demás procesos, incluidos los procesos del sistema operativo que realizan tareas importantes. Por ejemplo, un proceso en tiempo real que se ejecuta durante más de un intervalo muy breve puede hacer que las memorias caché de disco no se vacíen o que un mouse no responda.

Valor devuelto

Devuelve uno de los valores enumerados en la lista siguiente o un valor diferente para indicar un error. Para obtener códigos de error adicionales, consulte Constantes de error de WMI o WbemErrorEnum. Para obtener valores HRESULT generales, consulte Códigos de error del sistema.

Finalización correcta (0)

Acceso denegado (2)

Privilegio insuficiente (3)

Error desconocido (8)

Ruta de acceso no encontrada (9)

Parámetro no válido (21)

Otros (22 4294967295)

Comentarios

Para establecer la prioridad en Realtime, el autor de la llamada debe tener SeIncreaseBasePriorityPrivilege (SE_INC_BASE_PRIORITY_PRIVILEGE). Sin este privilegio, la prioridad más alta se puede establecer en es Prioridad alta.

Ejemplos

El ejemplo Modify the Priority Of a Running Process VBScript cambia la prioridad de una instancia en ejecución de Notepad.exe de Normal a Superior Normal.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Espacio de nombres	Root\CIMV2
MOF	CIMWin32.mof
Archivo DLL	CIMWin32.dll

Consulte también

Clases de sistema operativo

Win32_Process