Creazione di un'attività tramite l'esempio NewWorkItem

Quando si crea un'attività, si useranno due interfacce dell'Utilità di pianificazione: ITaskScheduler e ITask. È necessario specificare un nome univoco per l'attività, l'identificatore di classe dell'oggetto attività e l'identificatore dell'interfaccia di ITask. L'identificatore di classe e l'identificatore dell'interfaccia sono visualizzati nell'esempio di codice che segue questo argomento.

Nota

È anche possibile creare un'attività chiamando ITaskScheduler::AddWorkItem. Quando si segue questo percorso, è necessario creare un'istanza dell'oggetto attività (che supporta l'interfaccia ITask) e quindi aggiungere l'attività con il nome fornito.

 

Nota

Per impostazione predefinita, solo un membro del gruppo Administrators, Backup Operators o Server Operators può creare attività in Windows Server 2003. Un membro del gruppo Administrators può modificare il descrittore di sicurezza della cartella Windows\Task per consentire ad altri utenti di creare attività.

 

Il nome specificato per l'attività deve essere univoco all'interno della cartella Attività pianificate. Se esiste già un'attività con lo stesso nome, ITaskScheduler::NewWorkItem restituisce ERROR_FILE_EXISTS. Se si ottiene questo valore restituito, è necessario specificare un nome diverso e tentare di creare di nuovo l'attività.

La procedura seguente descrive come creare una nuova attività dell'elemento di lavoro.

Per creare una nuova attività di lavoro

1. Chiamare CoInitialize per inizializzare la libreria COM e CoCreateInstance per ottenere un oggetto Task Scheduler. In questo esempio si presuppone che il servizio Utilità di pianificazione sia in esecuzione.
2. Chiamare ITaskScheduler::NewWorkItem per creare una nuova attività. Questo metodo restituisce un puntatore a un'interfaccia ITask.
3. Salvare la nuova attività su disco chiamando IPersistFile::Save. L'interfacciaIPersistFileè un'interfaccia COM standard supportata dall'interfaccia ITask.
4. Chiamare ITask::Release per rilasciare tutte le risorse. Si noti che Release è un metodoIUnknownereditato da ITask.

Per un esempio di codice di	Vedere
Creazione di una singola attività	Esempio di codice C/C++ : Creazione di un'attività tramite newWorkItem

 

Argomenti correlati

Utilità di pianificazione attività 1.0 Esempi