ITaskScheduler::Activate-Methode (mstask.h)

  • Artikel

[[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 Activate-Methode gibt eine aktive Schnittstelle für ein angegebenes Arbeitselement zurück.

Syntax

HRESULT Activate(
  [in]  LPCWSTR  pwszName,
  [in]  REFIID   riid,
  [out] IUnknown **ppUnk
);

Parameter

[in] pwszName

Eine Zeichenfolge mit NULL-Beendigung, die den Namen des zu aktivierenden Arbeitselements angibt.

[in] riid

Ein Bezeichner, der die angeforderte Schnittstelle identifiziert. Die einzige zu diesem Zeitpunkt unterstützte Schnittstelle, ITask, verfügt über den Bezeichner IID_ITask.

[out] ppUnk

Ein Zeiger auf einen Schnittstellenzeiger, der die Adresse der angeforderten Schnittstelle empfängt.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben.

Wenn die Methode fehlschlägt, wird möglicherweise einer der folgenden Fehlercodes zurückgegeben.

Rückgabecode Beschreibung
COR_E_FILENOTFOUND
 Die Aufgabe ist nicht vorhanden.
E_INVALIDARG
 Der parameter pwszName ist ungültig.
E_OUTOFMEMORY
 Fehler bei der Speicherbelegung.
SCHED_E_UNKNOWN_OBJECT_VERSION
 Die Version des Aufgabenobjekts ist entweder nicht unterstützt oder ungültig.

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

Itask

ITaskScheduler