IRegisteredTask::GetInstances-Methode (taskschd.h)

Artikel
08/26/2023

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

HinweisIRegisteredTask::GetInstances gibt nur Instanzen der aktuell ausgeführten registrierten Aufgabe zurück, die mit oder unterhalb des Sicherheitskontexts eines Benutzers ausgeführt werden. Beispielsweise gibt GetInstances für Mitglieder der Gruppe Administratoren alle Instanzen der aktuell ausgeführten registrierten Aufgabe zurück, aber für Mitglieder der Gruppe Benutzer gibt GetInstances nur Instanzen der aktuell ausgeführten registrierten Aufgabe zurück, die unter dem Sicherheitskontext benutzergruppen 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 Zeiger ohne NULL 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 ungleich NULL wurde an den flags-Parameter übergeben.
E_POINTER	NULL wurde an den ppRunningTasks-Parameter übergeben.

Anforderungen


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

IRegisteredTask

IRunningTaskCollection

Aufgabenplanung

Share via