Metodo ITaskTrigger::SetTrigger (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 . ]

Il metodo SetTrigger imposta i criteri di trigger per un trigger di attività.

Sintassi

HRESULT SetTrigger(
  [in] const PTASK_TRIGGER pTrigger
);

Parametri

[in] pTrigger

Puntatore a una struttura TASK_TRIGGER contenente i valori che definiscono il nuovo trigger di attività.

Valore restituito

Il metodo SetTrigger restituisce uno dei valori seguenti.

Commenti

I membri wBeginDay, wBeginMonth e wBeginYear della struttura TASK_TRIGGER devono essere impostati rispettivamente su un giorno, un mese e un anno validi.

Un'attività può avere un numero qualsiasi di trigger associati. I tempi di esecuzione dell'attività sono l'unione di tutti i trigger definiti per tale attività.

Per aggiornare l'attività con queste nuove impostazioni di trigger, le applicazioni devono chiamare il metodo IPersistFile::Save dopo aver chiamato SetTrigger.

Esempio

Il codice seguente mostra la dichiarazione delle variabili e la sintassi chiamante per questo metodo, inclusi i membri necessari di TASK_TRIGGER. Impostazione dei criteri di trigger durante la creazione di un nuovo trigger, vedere Creazione di un nuovo trigger.

HRESULT hr = S_OK;

TASK_TRIGGER Trigger;

ZeroMemory(&Trigger, sizeof(TASK_TRIGGER));

Trigger.cbTriggerSize = sizeof(TASK_TRIGGER);
Trigger.wBeginDay = 1;
Trigger.wBeginMonth = 1;
Trigger.wBeginYear = 1999;

// pITaskTrigger is a previously assigned ITaskTrigger pointer.
hr = pITaskTrigger->SetTrigger(&Trigger);
if (FAILED(hr))
{
   printf("Failed SetTrigger\n");
   exit(1);
}

Requisiti

Vedi anche

IPersistFile::Save

ITaskTrigger

ITaskTrigger::GetTrigger

TASK_TRIGGER