Compartir a través de

Función de devolución de llamada LPFNPSPCALLBACKA (prsht.h)

  • Artículo

Especifica una función de devolución de llamada definida por la aplicación a la que una hoja de propiedades llama cuando se crea una página y cuando está a punto de destruirse. Una aplicación puede usar esta función para realizar operaciones de inicialización y limpieza para la página.

Sintaxis

LPFNPSPCALLBACKA Lpfnpspcallbacka;

UINT Lpfnpspcallbacka(
            HWND hwnd,
  [in]      UINT uMsg,
  [in, out] _PROPSHEETPAGEA *ppsp
)
{...}

Parámetros

hwnd

Tipo: HWND

Reservado; debe ser null.

[in] uMsg

Tipo: UINT de

Marca de acción. Este parámetro puede ser uno de los siguientes valores.

Valor Significado
PSPCB_ADDREF

versión 5.80 o posterior. Se crea una página. No se usa el valor devuelto.
PSPCB_CREATE
 Se crea un cuadro de diálogo para una página. Devuelve un valor distinto de cero para permitir que se cree o cero para evitarlo.
PSPCB_RELEASE
 Se está destruyendo una página. El valor devuelto se omite.

[in, out] ppsp

Tipo: LPPROPSHEETPAGE

Puntero a una estructura de PROPSHEETPAGE que define la página que se va a crear o destruir. Consulte la sección Comentarios para obtener más información.

Valor devuelto

Tipo: UINT de

El valor devuelto depende del valor del parámetro uMsg.

Observaciones

Una aplicación debe especificar la dirección de esta función de devolución de llamada en el pfnCallback miembro de una estructura de PROPSHEETPAGE antes de pasar la estructura a la función CreatePropertySheetPage .

Nota La hoja de propiedades está en proceso de manipular la lista de páginas cuando se llama a esta función. No intente agregar, quitar ni insertar páginas mientras controla esta notificación. Si lo hace, tendrá resultados imprevisibles.
 
Con la excepción del miembro lParam, la aplicación no debe modificar la estructura PROPSHEETPAGE. Si lo hace, tendrá resultados imprevisibles. El miembro lParam contiene datos definidos por la aplicación y se puede modificar según sea necesario.

Nota

El encabezado prsht.h define LPFNPSPCALLBACK como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

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