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

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.

Codice restituito	Descrizione
S_OK	L'operazione è stata completata.
E_INVALIDARG	Gli argomenti non sono validi.
E_OUTOFMEMORY	Memoria insufficiente.

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

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