Metodo ITask::SetPriority (mstask.h)
[[Questa API può essere modificata o non disponibile nelle versioni successive del sistema operativo o del prodotto. Usare invece le interfacce dell'Utilità di pianificazione 2.0 . ]
Questo metodo imposta la priorità per l'attività.
Sintassi
HRESULT SetPriority(
[in] DWORD dwPriority
);
Parametri
[in] dwPriority
DWORD che specifica la priorità per l'attività corrente. La priorità di un'attività determina la frequenza e la lunghezza delle sezioni temporali per un processo. Questo vale solo per i sistemi operativi Windows Server 2003, Windows XP e Windows 2000. Questi valori provengono dalla classe di priorità CreateProcess e possono essere uno dei flag seguenti (in ordine decrescente di priorità di pianificazione dei thread):
- REALTIME_PRIORITY_CLASS
- HIGH_PRIORITY_CLASS
- NORMAL_PRIORITY_CLASS
- IDLE_PRIORITY_CLASS
Valore restituito
Il metodo SetPriority restituisce uno dei valori seguenti.
| Codice restituito | Descrizione |
|---|---|
|
L'operazione è stata completata. |
|
Gli argomenti non sono validi. |
Commenti
Dopo aver impostato la priorità di un'attività, chiamare IPersistFile::Save per salvare l'oggetto attività modificato su disco.
Esempio
Per altre informazioni e un esempio di come impostare la priorità di un'attività, vedere Esempio di codice C/C++: Impostazione della priorità dell'attività.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | mstask.h |
| Libreria | Mstask.lib |
| DLL | Mstask.dll |