Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[[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 |