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
S_OK	L'operazione è stata completata.
E_INVALIDARG	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

Vedi anche

GetPriority

Itask