Metodo ITriggerCollection::Create (taskschd.h)

Articolo
07/16/2024

Crea un nuovo trigger per l'attività.

Sintassi

HRESULT Create(
  [in]  TASK_TRIGGER_TYPE2 type,
  [out] ITrigger           **ppTrigger
);

Parametri

[in] type

Questo parametro è impostato su una delle costanti di enumerazione TASK_TRIGGER_TYPE2 seguenti.

Valore	Significato
TASK_TRIGGER_EVENT 0	Attiva l'attività quando si verifica un evento specifico.
TASK_TRIGGER_TIME 1	Attiva l'attività in un'ora specifica del giorno.
TASK_TRIGGER_DAILY 2	Attiva l'attività in base a una pianificazione giornaliera. Ad esempio, l'attività inizia a un'ora specifica ogni giorno, ogni altro giorno, ogni terzo giorno e così via.
TASK_TRIGGER_WEEKLY 3	Attiva l'attività in base a una pianificazione settimanale. Ad esempio, l'attività inizia alle 8:00 di un giorno specifico ogni settimana o altra settimana.
TASK_TRIGGER_MONTHLY 4	Attiva l'attività in base a una pianificazione mensile. Ad esempio, l'attività viene avviata in giorni specifici di mesi specifici.
TASK_TRIGGER_MONTHLYDOW 5	Attiva l'attività in base a una pianificazione mensile giornaliera della settimana. Ad esempio, l'attività viene avviata in giorni specifici della settimana, settimane del mese e mesi dell'anno.
TASK_TRIGGER_IDLE 6	Attiva l'attività quando il computer entra in uno stato di inattività.
TASK_TRIGGER_REGISTRATION 7	Attiva l'attività quando l'attività viene registrata.
TASK_TRIGGER_BOOT 8	Attiva l'attività all'avvio del computer.
TASK_TRIGGER_LOGON 9	Attiva l'attività quando un utente specifico accede.
TASK_TRIGGER_SESSION_STATE_CHANGE 11	Attiva l'attività quando cambia lo stato di una sessione specifica.

[out] ppTrigger

Interfaccia ITrigger che rappresenta il nuovo trigger.

Passare un riferimento a un puntatore a interfaccia NULLITrigger. Fare riferimento a un puntatore null non può causare una perdita di memoria perché il puntatore verrà sovrascritto.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2008 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	taskschd.h
libreria	Taskschd.lib
dll	Taskschd.dll

Vedere anche

ITriggerCollection

'utilità di pianificazione

Condividi tramite