ITaskHandler::Start-Methode (taskschd.h)

Artikel
03/02/2024

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