Compartir a través de

Función MMCPropPageCallback (mmc.h)

  • Artículo

Los complementos basados en Microsoft Foundation Classes (MFC) solo requieren la función MMCPropPageCallback . La función establece el estado correcto del módulo durante la creación de la página.

Sintaxis

HRESULT MMCPropPageCallback(
  void *vpsp
);

Parámetros

vpsp

Puntero a la estructura PROPSHEETPAGE de Microsoft Windows. Tenga en cuenta que, de forma predeterminada, MFC instala su propia devolución de llamada en el miembro pfnCallback de la estructura.

Valor devuelto

Esta función de devolución de llamada puede devolver uno de estos valores.

Comentarios

Los complementos que vinculan estáticamente las bibliotecas MFC no deben llamar a esta función. Una llamada a esta función por este complemento no se vinculará correctamente.

Para cada página derivada de CPropertyPage, llame a MMCPropPageCallback con un puntero a la devolución de llamada de la página, siguiendo estas directrices:

  • Todas las páginas de una hoja de propiedades determinada deben usar el mismo puntero de devolución de llamada.
  • Si reemplaza la devolución de llamada de MFC por la suya propia, la devolución de llamada debe llamar a la devolución de llamada de MFC.
  • Debe llamar a esta función con cada clase derivada de CPropertyPage .
MFC debe tener el estado correcto del módulo establecido a partir de funciones exportadas o interfaces COM. Esto incluye llamadas realizadas desde el sistema operativo al módulo. Para las funciones exportadas o interfaces COM, esto se hace agregando la macro AFX_MANAGE_STATE al principio de todas las funciones exportadas en archivos DLL de complemento que se vinculan dinámicamente a MFC. Para ello, agregue la siguiente línea de código al principio de las funciones exportadas desde el complemento:
AFX_MANAGE_STATE(AfxGetStaticModuleState( ))

Para una llamada de sistema operativo, MFC lo hace automáticamente. Dado que la hoja de propiedades de MMC no es una CPropertySheet de MFC, la llamada del sistema operativo debido a la devolución de llamada está en estado de módulo incorrecto. Como resultado, debe asegurarse de que el estado del módulo está configurado correctamente durante la creación de la página. Este es el propósito de MMCPropPageCallback. Una vez establecido el estado del módulo, las únicas llamadas AFX_MANAGE_STATE que deben realizarse son las expuestas por las interfaces COM implementadas por el complemento (por ejemplo , IExtendPropertySheet2::CreatePropertyPages). Para determinar si la aplicación tiene el estado correcto del módulo, examine CWinApp y anote el nombre de la aplicación.

Requisitos

   
Cliente mínimo compatible Windows Vista
Servidor mínimo compatible Windows Server 2008
Plataforma de destino Windows
Encabezado mmc.h

Consulte también

PROPSHEETPAGE