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 |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Die Argumente sind ungültig. |
|
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 |