Metodo ITaskTrigger::SetTrigger (mstask.h)

Articolo
02/29/2024

[[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.

Codice restituito	Descrizione
S_OK	L'operazione è stata completata.
E_INVALIDARG	Gli argomenti non sono validi.
E_OUTOFMEMORY	Memoria insufficiente.

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

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