ITaskService::GetRunningTasks-Methode (taskschd.h)

Ruft eine Auflistung ausgeführter Aufgaben ab.

HinweisITaskService::GetRunningTasks gibt nur eine Sammlung ausgeführter Aufgaben zurück, die mit oder unterhalb des Sicherheitskontexts eines Benutzers ausgeführt werden. Beispielsweise gibt GetRunningTasks für Mitglieder der Gruppe Administratoren eine Auflistung aller ausgeführten Aufgaben zurück, aber für Mitglieder der Gruppe Benutzer gibt GetRunningTasks nur eine Auflistung von Aufgaben zurück, die unter dem Sicherheitskontext der Benutzergruppe ausgeführt werden.

 

Syntax

HRESULT GetRunningTasks(
  [in]  LONG                   flags,
  [out] IRunningTaskCollection **ppRunningTasks
);

Parameter

[in] flags

Ein Wert aus der TASK_ENUM_FLAGS-Enumeration . Übergeben Sie 0, um eine Sammlung ausgeführter Aufgaben zurückzugeben, bei denen es sich nicht um ausgeblendete Aufgaben handelt.

[out] ppRunningTasks

Eine IRunningTaskCollection-Schnittstelle , die die aktuell ausgeführten Aufgaben enthält.

Übergeben Sie einen Verweis auf einen NULL-IRunningTaskCollection-Schnittstellenzeiger. Das Verweisen auf einen Nicht-NULL-Zeiger kann zu einem Speicherverlust führen, da der Zeiger überschrieben wird.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

	BESCHREIBUNG
E_INVALIDARG	Im Methodenaufruf wurde ein ungültiges Argument angegeben. Das Übergeben eines nonzero-Werts an den Flags-Parameter gibt E_INVALIDARG zurück.
S_OK	Der Vorgang wurde erfolgreich abgeschlossen.
E_POINTER	NULL wurde an den retVal-Parameter übergeben.
HRESULT_FROM_WIN32(ERROR_ONLY_IF_CONNECTED)	Der Benutzer hat keine Verbindung mit dem Dienst hergestellt.

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

Weitere Informationen

IRunningTaskCollection

ITaskService

TASK_ENUM_FLAGS

Aufgabenplanung