Skip to content

Latest commit

 

History

History
75 lines (60 loc) · 3.7 KB

nf-prsht-propsheet_getresult.md

File metadata and controls

75 lines (60 loc) · 3.7 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:prsht.PropSheet_GetResult
PropSheet_GetResult macro (prsht.h)
Used by modeless property sheets to retrieve the information returned to modal property sheets by PropertySheet. You can use this macro or sent the PSM_GETRESULT message explicitly.
PropSheet_GetResult
PropSheet_GetResult macro [Windows Controls]
_win32_PropSheet_GetResult
_win32_PropSheet_GetResult_cpp
controls.PropSheet_GetResult
controls._win32_PropSheet_GetResult
prsht/PropSheet_GetResult
controls\PropSheet_GetResult.htm
Controls
VS|Controls|~\controls\propsheet\macros\propsheet_getresult.htm
12/05/2018
PropSheet_GetResult, PropSheet_GetResult macro [Windows Controls], _win32_PropSheet_GetResult, _win32_PropSheet_GetResult_cpp, controls.PropSheet_GetResult, controls._win32_PropSheet_GetResult, prsht/PropSheet_GetResult
prsht.h
Windows
Windows Vista [desktop apps only]
Windows Server 2003 [desktop apps only]
Windows
19H1
PropSheet_GetResult
prsht/PropSheet_GetResult
c++
APIRef
kbSyntax
HeaderDef
Prsht.h
PropSheet_GetResult

PropSheet_GetResult macro

-description

Used by modeless property sheets to retrieve the information returned to modal property sheets by PropertySheet. You can use this macro or sent the PSM_GETRESULT message explicitly.

-parameters

-param hDlg

Type: HWND

Handle to the property sheet's dialog box.

-remarks

To retrieve extended error information, call GetLastError.

The return value is identical to what PropertySheet would have returned had this been a modal property sheet.

Version 5.80. The PropertySheet return value carries different information for modal and modeless property sheets. In some cases, modeless property sheets may need the information they would have received from PropertySheet if they had been modal. In particular, they may need to know whether ID_PSREBOOTSYSTEM or ID_PSRESTARTWINDOWS would have been returned.

For a modeless property sheet, your message loop should use PSM_ISDIALOGMESSAGE to pass messages to the property sheet dialog box, and PSM_GETCURRENTPAGEHWND to determine when to destroy the dialog box. When the user clicks the OK or Cancel button, PSM_GETCURRENTPAGEHWND returns NULL. You can then retrieve the value that a modal property sheet would have received from PropertySheet by sending a PSM_GETRESULT message.

Note  This macro is not supported when using the Aero wizard style (PSH_AEROWIZARD).