IProvideTaskPage::GetPage-Methode (mstask.h)

[[Diese API kann in nachfolgenden Versionen des Betriebssystems oder Produkts geändert oder nicht verfügbar sein. Verwenden Sie stattdessen die Taskplaner 2.0-Schnittstellen .] ]

Diese Methode ruft eine oder mehrere Eigenschaftenblattseiten ab, die einem Aufgabenobjekt zugeordnet sind.

Syntax

HRESULT GetPage(
  [in]  TASKPAGE       tpType,
  [in]  BOOL           fPersistChanges,
  [out] HPROPSHEETPAGE *phPage
);

Parameter

[in] tpType

Einer der folgenden TASKPAGE-Enumerationswerte , der die zurückzugebende Seite angibt.

TASKPAGE_TASK

Allgemeine Seiteneigenschaft.

TASKPAGE_SCHEDULE

Planen von Eigenschaften für den Vorgang.

TASKPAGE_SETTINGS

Einstellungseigenschaften für die Aufgabe.

[in] fPersistChanges

Gibt an, ob Änderungen am Aufgabenobjekt automatisch persistent vorgenommen werden. Bei TRUE aktualisiert die Seite das Objekt der persistenten Aufgabe automatisch, wenn bei der Veröffentlichung eine Änderung vorgenommen wurde. Wenn FALSE, ist der Aufrufer dafür verantwortlich, aufgabenobjektänderungen dauerhaft zu machen, indem IPersistFile::Save für das Aufgabenobjekt aufgerufen wird.

[out] phPage

Handle für die zurückgegebene Eigenschaftenblattseite des Taskobjekts. Dieses Handle kann dann verwendet werden, um die Seite anzuzeigen.

Rückgabewert

Gibt S_OK zurück, wenn die Methode erfolgreich war, oder STG_E_NOTFILEBASEDSTORAGE, wenn die Aufgabe nicht auf dem Datenträger gespeichert wurde.

Hinweise

Rufen Sie ITask::QueryInterface auf, um die IProvideTaskPage-Schnittstelle abzurufen.

Der folgende Code zeigt die Variablendeklaration und die Aufrufssyntax für die Verwendung dieser Methode und für den Aufruf von ITask::QueryInterface.

Beispiele

Ein vollständiges Beispiel für das Abrufen und Anzeigen der allgemeinen Aufgabenseite einer bekannten Aufgabe finden Sie unter Abrufen einer Vorgangsseite –Beispiel.

Anforderungen

Weitere Informationen

IProvideTaskPage

TASKPAGE