Condividi tramite


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
S_OK
L'operazione è stata completata.
ERROR_FILE_EXISTS
Esiste già un'attività con il nome specificato. Il valore restituito effettivo è HRESULT_FROM_WIN32(ERROR_FILE_EXISTS).
E_INVALIDARG
Uno o più argomenti non sono validi.
E_OUTOFMEMORY
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

Vedi anche

IScheduledWorkItem

ITaskScheduler

ITaskScheduler::NewWorkItem