Estructura PSPINFO (compstui.h)

La estructura PSPINFO se usa como parámetro de entrada para el procedimiento del cuadro de diálogo de una página de hojas de propiedades, cuando se WM_INITDIALOG el mensaje de Windows. La dirección del procedimiento del cuadro de diálogo se especifica en una estructura DLGPAGE.

Sintaxis

typedef struct _PSPINFO {
  WORD            cbSize;
  WORD            wReserved;
  HANDLE          hComPropSheet;
  HANDLE          hCPSUIPage;
  PFNCOMPROPSHEET pfnComPropSheet;
} PSPINFO, *PPSPINFO;

Miembros

cbSize

Tamaño proporcionado por CPSUI, en bytes, de la estructura de PSPINFO.

wReserved

Reservado.

hComPropSheet

Identificador proporcionado por CPSUI al elemento primario de la página cuyo identificador está contenido en hCPSUIPage.

hCPSUIPage

Identificador proporcionado por CPSUI a la página de la hoja de propiedades.

pfnComPropSheet

Puntero proporcionado por CPSUI a su función ComPropSheet.

Observaciones

Antes de que CPSUI llame a CreatePropertySheetPage para crear una página de hoja de propiedades, expande el tamaño de la estructura estándar PROPSHEETPAGE para anexar una estructura PSPINFO. Cuando el sistema operativo llama a un procedimiento de cuadro de diálogo (al que apunta un estructura DLGPAGE) y especifica un mensaje de WM_INITDIALOG, el miembro lParam apunta a la estructura expandida PROPSHEETPAGE que contiene la estructura PSPINFO.

Para obtener la dirección del PSPINFO estructura, use la macro PPSPINFO_FROM_WM_INITDIALOG_LPARAM (definida en compstui.h) como se indica a continuación:

PPSPINFO pPspInfo;
if (Msg == WM_INITDIALOG) {
    pPspInfo = PPSPINFO_FROM_WM_INITDIALOG_LPARAM(lParam);
}

El puntero de estructura PSPINFO se puede guardar para su uso posterior, pero el contenido de la estructura no debe modificarse.

Requisitos

Requisito	Valor
encabezado de	compstui.h (include Compstui.h)