Metodo ITaskScheduler::AddWorkItem (mstask.h)

Articolo
08/25/2023

[[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

Share via