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

Elimina un trigger da un elemento di lavoro.

Sintassi

HRESULT DeleteTrigger(
  [in] WORD iTrigger
);

Parametri

[in] iTrigger

Valore di indice del trigger che specifica il trigger da eliminare. Per altre informazioni, vedere la sezione Osservazioni.

Valore restituito

Il metodo DeleteTrigger 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

Viene creato un indice trigger per ogni trigger quando viene creato il trigger. Tuttavia, non è un identificatore univoco per un trigger specifico. Ad esempio, se si creano quattro trigger, verranno numerati da 0 a 3. Tuttavia, se il secondo trigger viene eliminato, i trigger rimanenti verranno numerati da 0 a 2. Si noti che l'indice del primo trigger è sempre 0 e l'indice dell'ultimo trigger è minore del numero totale di trigger per l'elemento di lavoro (TriggerCount -1).

È possibile recuperare il conteggio dei trigger usando IScheduledWorkItem::GetTriggerCount.

Per completare l'eliminazione del trigger, i programmi devono chiamare il metodo IPersistFile::Save dopo aver chiamato DeleteTrigger. La chiamata a IPersistFile::Save salva le modifiche apportate al disco.

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

CreateTrigger

IScheduledWorkItem

IScheduledWorkItem::GetTriggerCount