ITaskHandler::Start-Methode (taskschd.h)
Wird aufgerufen, um den COM-Handler zu starten. Diese Methode muss vom Handler implementiert werden.
Syntax
HRESULT Start(
[in] IUnknown *pHandlerServices,
[in] BSTR data
);
Parameter
[in] pHandlerServices
Eine IUnkown-Schnittstelle , die für die Kommunikation mit dem Aufgabenplaner verwendet wird.
[in] data
Die Argumente, die vom Handler benötigt werden. Diese Argumente werden in der Data-Eigenschaft der COM-Handleraktion definiert.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Bei der Implementierung dieser Methode sollte der Handler die Steuerung sofort an den Aufgabenplaner zurückgeben (wenn inproc ein eigener Thread gestartet wird).
Nachdem der Handler mit der Verarbeitung begonnen hat, kann er die UpdateStatus-Methode aufrufen, um den Prozentsatz der Vervollständigung anzugeben, oder die TaskCompleted-Methode aufrufen, um anzugeben, wann der Handler seine Verarbeitung abgeschlossen hat. Diese Methoden werden von der ITaskHandlerStatus-Schnittstelle bereitgestellt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | taskschd.h |
| Bibliothek | Taskschd.lib |
| DLL | Taskschd.dll |