Freigeben über


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