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.

Rückgabecode	BESCHREIBUNG
S_OK	Der Vorgang wurde durchgeführt.
E_INVALIDARG	Die Argumente sind ungültig.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher verfügbar.

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

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mstask.h
Bibliothek	Mstask.lib
DLL	Mstask.dll
Verteilbare Komponente	Internet Explorer 4.0 oder höher unter Windows NT 4.0 und Windows 95

Weitere Informationen

IPersistFile::Save

ITaskTrigger

ITaskTrigger::GetTrigger

TASK_TRIGGER