ITaskScheduler::Activate-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 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 |
|---|---|
|
Die Aufgabe ist nicht vorhanden. |
|
Der parameter pwszName ist ungültig. |
|
Fehler bei der Speicherbelegung. |
|
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 |