Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
Der Vorgang wurde erfolgreich abgeschlossen. |
|
Ein Flag ohne Null wurde an die Flags Parameter übergeben. |
|
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 |