PropSheet_GetResult Makro (prsht.h)

Wird von moduslosen Eigenschaftenblättern verwendet, um die Informationen abzurufen, die von PropertySheet-an modale Eigenschaftenblätter zurückgegeben werden. Sie können dieses Makro verwenden oder die PSM_GETRESULT Nachricht explizit senden.

Syntax

int PropSheet_GetResult(
   HWND hDlg
);

Parameter

hDlg

Typ: HWND-

Behandeln sie das Dialogfeld des Eigenschaftenblatts.

Rückgabewert

Typ: int

Gibt einen positiven Wert zurück, wenn dies erfolgreich ist, oder -1 andernfalls. Die folgenden Rückgabewerte haben eine besondere Bedeutung.

Rückgabecode	Beschreibung
ID_PSREBOOTSYSTEM	Eine Seite hat eine PSM_REBOOTSYSTEM Nachricht an das Eigenschaftenblatt gesendet. Der Computer muss neu gestartet werden, damit die Änderungen des Benutzers wirksam werden.
ID_PSRESTARTWINDOWS	Eine Seite hat eine PSM_RESTARTWINDOWS Nachricht an das Eigenschaftenblatt gesendet. Windows muss neu gestartet werden, damit die Änderungen des Benutzers wirksam werden.

Bemerkungen

Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen abzurufen.

Der Rückgabewert ist identisch mit dem, was PropertySheet- zurückgegeben hätte, wenn es sich um ein modales Eigenschaftenblatt handelte.

Version 5.80. Der PropertySheet- Rückgabewert enthält unterschiedliche Informationen für modale und moduslose Eigenschaftenblätter. In einigen Fällen benötigen modelose Eigenschaftenblätter möglicherweise die Informationen, die sie von PropertySheet erhalten hätten, wenn sie modal waren. Insbesondere müssen sie möglicherweise wissen, ob ID_PSREBOOTSYSTEM oder ID_PSRESTARTWINDOWS zurückgegeben worden wären.

Bei einem moduslosen Eigenschaftenblatt sollte ihre Nachrichtenschleife PSM_ISDIALOGMESSAGE verwenden, um Nachrichten an das Eigenschaftenblattdialogfeld zu übergeben, und PSM_GETCURRENTPAGEHWND, um zu bestimmen, wann das Dialogfeld zerstört werden soll. Wenn der Benutzer auf die Schaltfläche OK oder Schaltfläche "Abbrechen" klickt, gibt PSM_GETCURRENTPAGEHWNDNULL-zurück. Anschließend können Sie den Wert abrufen, den ein modales Eigenschaftenblatt von PropertySheet- erhalten hätte, indem Sie eine PSM_GETRESULT Nachricht senden.

Hinweis Dieses Makro wird bei Verwendung des Aero-Assistentenstils (PSH_AEROWIZARD) nicht unterstützt.

 

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	prsht.h