Metodo ITaskScheduler::AddWorkItem (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 . ]
Il metodo AddWorkItem aggiunge un'attività alla pianificazione delle attività.
Sintassi
HRESULT AddWorkItem(
[in] LPCWSTR pwszTaskName,
[in] IScheduledWorkItem *pWorkItem
);
Parametri
[in] pwszTaskName
Stringa con terminazione Null che specifica il nome dell'attività da aggiungere. Il nome dell'attività deve essere conforme alle convenzioni di denominazione dei file di Windows NT, ma non può includere barre rovesciata perché l'annidamento all'interno dell'oggetto cartella attività non è consentito.
[in] pWorkItem
Puntatore all'attività da aggiungere alla pianificazione.
Valore restituito
Il metodo AddWorkItem restituisce uno dei valori seguenti.
| Codice restituito | Descrizione |
|---|---|
|
L'operazione è stata completata. |
|
Esiste già un'attività con il nome specificato. Il valore restituito effettivo è HRESULT_FROM_WIN32(ERROR_FILE_EXISTS). |
|
Uno o più argomenti non sono validi. |
|
Memoria insufficiente per completare l’operazione. |
Commenti
L'utilità di pianificazione delle attività fornisce due metodi per l'aggiunta di elementi di lavoro: NewWorkItem e AddWorkItem. Di questi metodi, ognuno ha il suo vantaggio specifico. AddWorkItem impedisce conflitti di denominazione, ma richiede anche due operazioni di scrittura su disco per chiamata. Un'operazione di scrittura viene eseguita quando la chiamata a AddWorkItem crea un oggetto elemento di lavoro vuoto sul disco, seguito da un'altra operazione di scrittura quando viene chiamato IPersistFile::Save .
NewWorkItem non impedisce conflitti di denominazione, ma richiede solo un'operazione di scrittura su disco quando viene chiamato IPersistFile::Save . Anche se NewWorkItem è più efficiente con le operazioni di scrittura su disco, l'applicazione rischia di creare un altro elemento di lavoro con lo stesso nome prima che venga eseguita la chiamata a IPersistFile::Save .
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 |
| Componente ridistribuibile | Internet Explorer 4.0 o versione successiva in Windows NT 4.0 e Windows 95 |