Condividi tramite


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