ITaskTrigger::SetTrigger-Methode (mstask.h)

[[Diese API kann in nachfolgenden Versionen des Betriebssystems oder Produkts geändert oder nicht verfügbar sein. Verwenden Sie stattdessen die Taskplaner 2.0-Schnittstellen .] ]

Die SetTrigger-Methode legt die Triggerkriterien für einen Tasktrigger fest.

Syntax

HRESULT SetTrigger(
  [in] const PTASK_TRIGGER pTrigger
);

Parameter

[in] pTrigger

Ein Zeiger auf eine TASK_TRIGGER-Struktur , die die Werte enthält, die den neuen Tasktrigger definieren.

Rückgabewert

Die SetTrigger-Methode gibt einen der folgenden Werte zurück.

Hinweise

Die Elemente wBeginDay, wBeginMonth und wBeginYear der TASK_TRIGGER-Struktur müssen auf einen gültigen Tag, Monat und Jahr festgelegt werden.

Einem Task kann eine beliebige Anzahl von Triggern zugeordnet sein. Die Zeiten, zu denen der Task ausgeführt wird, sind die Union aller Trigger, die für diesen Task definiert sind.

Um die Aufgabe mit diesen neuen Triggereinstellungen zu aktualisieren, müssen Anwendungen die IPersistFile::Save-Methode aufrufen, nachdem SetTrigger aufgerufen wurde.

Beispiele

Der folgende Code zeigt die Variablendeklaration und die Aufrufensyntax für diese Methode, einschließlich der erforderlichen Member von TASK_TRIGGER. Festlegen der Triggerkriterien beim Erstellen eines neuen Triggers finden Sie unter Erstellen eines neuen Triggers.

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);
}

Anforderungen

Weitere Informationen

IPersistFile::Save

ITaskTrigger

ITaskTrigger::GetTrigger

TASK_TRIGGER