Metodo IShellTaskScheduler::AddTask (shobjidl_core.h)

Articolo
03/13/2024

Aggiunge un'attività alla coda in background dell'utilità di pianificazione.

Sintassi

HRESULT AddTask(
  [in] IRunnableTask  *prt,
  [in] REFTASKOWNERID rtoid,
  [in] DWORD_PTR      lParam,
  [in] DWORD          dwPriority
);

Parametri

[in] prt

Tipo: IRunnableTask*

Puntatore a un'istanza di un'interfaccia IRunnableTask che rappresenta l'attività da aggiungere alla coda.

[in] rtoid

Tipo: REFTASKOWNERID

GUID che identifica il proprietario dell'attività. Queste informazioni possono essere usate per raggruppare le attività per il conteggio o la rimozione in un secondo momento da parte del proprietario.

[in] lParam

Tipo: DWORD_PTR

Puntatore a un valore DWORD definito dall'utente che consente di identificare l'attività all'interno delle attività di proprietà di rtoid. Viene usato per identificare singole attività o per raggrupparle, ad esempio associando l'attività a un determinato elemento, ad esempio un elemento in un controllo ListView. Questo parametro può essere zero.

[in] dwPriority

Tipo: DWORD

Uno dei valori seguenti che assegnano la priorità dell'attività. La risposta a questa priorità dipende dalla cooperazione delle altre attività eseguite. Le nuove attività vengono inserite nella coda in ordine di priorità. Se un'attività con priorità bassa è attualmente in esecuzione quando viene aggiunta un'attività con priorità più alta, l'utilità di pianificazione tenta di sospendere l'attività in esecuzione. L'attività con priorità più bassa viene ripresa quando vengono completate le attività con priorità più alta.

ITSAT_DEFAULT_PRIORITY

Accettare la priorità predefinita assegnata all'attività dall'utilità di pianificazione.

ITSAT_MAX_PRIORITY

Ad alta priorità.

ITSAT_MIN_PRIORITY

A bassa priorità.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

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	shobjidl_core.h (include Shobjidl.h)
DLL	Shell32.dll (versione 5.0 o successiva)

Condividi tramite