Metodo ITriggerCollection::Create (taskschd.h)

Articolo
03/05/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 seguenti TASK_TRIGGER_TYPE2 .

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 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 una pianificazione settimanale. Ad esempio, l'attività inizia alle 8:00 in un giorno specifico ogni settimana o altra settimana.
TASK_TRIGGER_MONTHLY 4	Attiva l'attività in una pianificazione mensile. Ad esempio, l'attività viene avviata in giorni specifici di mesi specifici.
TASK_TRIGGER_MONTHLYDOW 5	Attiva l'attività su una pianificazione mensile giornaliera della settimana. Ad esempio, l'attività viene avviata in giorni specifici della settimana, delle settimane del mese e dei mesi dell'anno.
TASK_TRIGGER_IDLE 6	Attiva l'attività quando il computer entra in uno stato inattiva.
TASK_TRIGGER_REGISTRATION 7	Attiva l'attività quando l'attività viene registrata.
TASK_TRIGGER_BOOT 8	Attiva l'attività quando il computer viene avviato.
TASK_TRIGGER_LOGON 9	Attiva l'attività quando un utente specifico accede.
TASK_TRIGGER_SESSION_STATE_CHANGE 11	Attiva l'attività quando viene modificato uno stato di sessione specifico.

[out] ppTrigger

Interfaccia ITrigger che rappresenta il nuovo trigger.

Passare un riferimento a un puntatore dell'interfaccia ITriggerNULL. Il riferimento a un puntatore non NULL 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 .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	taskschd.h
Libreria	Taskschd.lib
DLL	Taskschd.dll

Vedi anche

ITriggerCollection

Utilità di pianificazione

Condividi tramite