ITaskService::GetRunningTasks-Methode (taskschd.h)

Artikel
07/16/2024

Ruft eine Auflistung der ausgeführten Aufgaben ab.

HinweisITaskService::GetRunningTasks gibt nur eine Sammlung von ausgeführten Aufgaben zurück, die im oder unterhalb des Sicherheitskontexts eines Benutzers ausgeführt werden. Für Mitglieder der Gruppe "Administratoren" gibt "GetRunningTasks" beispielsweise eine Sammlung aller ausgeführten Aufgaben zurück, aber für Mitglieder der Gruppe "Benutzer" gibt "GetRunningTasks"- nur eine Sammlung von Aufgaben zurück, die im Sicherheitskontext der Gruppe "Benutzer" ausgeführt werden.

Syntax

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

Parameter

[in] flags

Ein Wert aus der TASK_ENUM_FLAGS-Aufzählung. Übergeben Sie 0, um eine Sammlung ausgeführter Aufgaben zurückzugeben, die keine ausgeblendeten Aufgaben sind.

[out] ppRunningTasks

Eine IRunningTaskCollection Schnittstelle, die die derzeit 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. Wenn ein Wert ungleich Null an die Flags Parameter übergeben wird, wird E_INVALIDARGzurückgegeben.
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
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2008 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	taskschd.h
Library	Taskschd.lib
DLL-	Taskschd.dll

Siehe auch

IRunningTaskCollection-

ITaskService-

TASK_ENUM_FLAGS

Aufgabenplaner-

Freigeben über