Compartir a través de

macro PropSheet_GetResult (prsht.h)

  • Artículo

Usado por las hojas de propiedades modeless para recuperar la información devuelta a las hojas de propiedades modales por PropertySheet. Puede usar esta macro o enviar explícitamente el mensaje PSM_GETRESULT.

Sintaxis

int PropSheet_GetResult(
   HWND hDlg
);

Parámetros

hDlg

Tipo: HWND

Identificador del cuadro de diálogo de la hoja de propiedades.

Valor devuelto

Tipo: int

Devuelve un valor positivo si se ejecuta correctamente o -1 de lo contrario. Los siguientes valores devueltos tienen un significado especial.

Código devuelto Descripción
ID_PSREBOOTSYSTEM Una página envió un mensaje PSM_REBOOTSYSTEM a la hoja de propiedades. El equipo debe reiniciarse para que los cambios del usuario surtan efecto.
ID_PSRESTARTWINDOWS Una página envió un mensaje de PSM_RESTARTWINDOWS a la hoja de propiedades. Windows debe reiniciarse para que los cambios del usuario surtan efecto.

Observaciones

Para recuperar información de error extendida, llame a GetLastError.

El valor devuelto es idéntico al que PropertySheet habría devuelto si se hubiera producido una hoja de propiedades modal.

Versión 5.80. El PropertySheet valor devuelto contiene información diferente para las hojas de propiedades modales y modeless. En algunos casos, las hojas de propiedades modeless pueden necesitar la información que habrían recibido de PropertySheet si hubieran sido modales. En concreto, es posible que necesiten saber si se habría devuelto ID_PSREBOOTSYSTEM o ID_PSRESTARTWINDOWS.

Para una hoja de propiedades modeless, el bucle de mensajes debe usar PSM_ISDIALOGMESSAGE para pasar mensajes al cuadro de diálogo de la hoja de propiedades y PSM_GETCURRENTPAGEHWND determinar cuándo destruir el cuadro de diálogo. Cuando el usuario hace clic en el aceptar o botón Cancelar, PSM_GETCURRENTPAGEHWND devuelve NULL . A continuación, puede recuperar el valor que una hoja de propiedades modal habría recibido de PropertySheet enviando un mensaje de PSM_GETRESULT.

Nota Esta macro no se admite al usar el estilo del asistente Aero (PSH_AEROWIZARD).
 

Requisitos

Requisito Valor
cliente mínimo admitido Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de prsht.h