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

Siehe auch

ITaskFolder-