ITaskFolder::GetTask-Methode (taskschd.h)
Ruft eine Aufgabe an einem angegebenen Speicherort in einem Ordner ab.
Syntax
HRESULT GetTask(
[in] BSTR path,
[out] IRegisteredTask **ppTask
);
Parameter
[in] path
Der Pfad (Speicherort) zur Aufgabe in einem Ordner. Der Stammaufgabenordner wird mit einem umgekehrten Schrägstrich (\) angegeben. Ein Beispiel für einen Aufgabenordnerpfad unter dem Stammaufgabenordner ist \MyTaskFolder. Das Zeichen '.' kann nicht zum Angeben des aktuellen Aufgabenordners und des '.' verwendet werden. Zeichen können nicht verwendet werden, um den übergeordneten Aufgabenordner im Pfad anzugeben.
[out] ppTask
Der Vorgang an der angegebenen Position.
Übergeben Sie einen Verweis auf einen NULL-IRegisteredTask- Schnittstellenzeiger. Das Verweisen auf einen Nicht-NULL- Zeiger kann zu einem Speicherverlust führen, da der Zeiger überschrieben wird.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OKzurückgegeben. Andernfalls wird ein HRESULT- Fehlercode zurückgegeben.
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 |