Condividi tramite

Creazione di un'attività tramite l'esempio NewWorkItem

  • Articolo

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 di interfaccia ITask. L'identificatore di classe e l'identificatore dell'interfaccia sono illustrati nell'esempio di codice che segue questo argomento.

Nota

È anche possibile creare un'attività chiamando ITaskScheduler::AddWorkItem. Quando si esegue questa route, è responsabilità dell'utente creare un'istanza dell'oggetto Task (che supporta l'interfaccia ITask ) e quindi aggiungere l'attività con il nome specificato.

 

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à elemento di lavoro.

Per creare una nuova attività elemento di lavoro

  1. Chiamare CoInitialize per inizializzare la libreria COM e CoCreateInstance per ottenere un oggetto Utilità di pianificazione. 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'interfaccia IPersistFile è un'interfaccia COM standard supportata dall'interfaccia ITask .
  4. Chiamare ITask::Release per rilasciare tutte le risorse. Si noti che Release è un metodo IUnknown ereditato 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

 

Esempi di Utilità di pianificazione 1.0