Metodo IScheduledWorkItem::CreateTrigger (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 . ]

Crea un trigger per l'elemento di lavoro.

Sintassi

HRESULT CreateTrigger(
  [out] WORD         *piNewTrigger,
  [out] ITaskTrigger **ppTrigger
);

Parametri

[out] piNewTrigger

Puntatore al valore di indice trigger restituito del nuovo trigger. L'indice del trigger per il primo trigger associato a un elemento di lavoro è "0". Vedere La sezione Osservazioni per altri usi dell'indice del trigger.

[out] ppTrigger

Puntatore a un puntatore a un'interfaccia ITaskTrigger . Attualmente, gli unici elementi di lavoro supportati sono attività.

Valore restituito

Il metodo CreateTrigger restituisce uno dei valori seguenti.

Commenti

Quando si recuperano o si eliminano trigger, si usa l'indice trigger restituito da piNewTrigger . Tuttavia, l'indice del trigger non è un identificatore. Indica solo la posizione del nuovo trigger rispetto agli altri trigger correnti associati all'elemento di lavoro.

Per impostare i criteri per il nuovo trigger, chiamare ITaskTrigger::SetTrigger.

Dopo aver creato un nuovo trigger per un elemento di lavoro, le applicazioni devono chiamare il metodo IPersistFile::Save per salvare il nuovo trigger su disco.

Esempio

Per un esempio di come impostare i criteri di trigger durante la creazione di un nuovo trigger, vedere Creazione di un nuovo trigger.

Requisiti

Vedi anche

IPersistFile::Save

IScheduledWorkItem

IScheduledWorkItem::D eleteTrigger

IScheduledWorkItem::GetTrigger

IScheduledWorkItem::GetTriggerString

ITaskTrigger

ITaskTrigger::SetTrigger