IRegisteredTask::GetInstances-Methode (taskschd.h)

Gibt alle Instanzen der aktuell ausgeführten registrierten Aufgabe zurück.

HinweisIRegisteredTask::GetInstances gibt nur Instanzen der aktuell ausgeführten registrierten Aufgabe zurück, die im oder unterhalb des Sicherheitskontexts eines Benutzers ausgeführt werden. Für Mitglieder der Gruppe "Administratoren" gibt "GetInstances" beispielsweise alle Instanzen der aktuell ausgeführten registrierten Aufgabe zurück, "GetInstances" gibt jedoch nur Instanzen der aktuell ausgeführten registrierten Aufgabe zurück, die im Gruppensicherheitskontext "Benutzer" ausgeführt werden.

 

Syntax

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

Parameter

flags

Dieser Parameter ist für die zukünftige Verwendung reserviert und muss auf 0 festgelegt werden.

[out] ppRunningTasks

Eine IRunningTaskCollection Schnittstelle, die alle derzeit ausgeführten Instanzen der Aufgabe im Kontext des Benutzers 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.

Rückgabecode	Beschreibung
S_OK	Der Vorgang wurde erfolgreich abgeschlossen.
E_INVALIDARG	Ein Flag ohne Null wurde an die Flags Parameter übergeben.
E_POINTER	NULL wurde an den ppRunningTasks Parameter übergeben.

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

IRegisteredTask-

IRunningTaskCollection-

Aufgabenplaner-