Função MMCPropPageCallback (mmc.h)

A função MMCPropPageCallback só é exigida por snap-ins baseados em MFC (Microsoft Foundation Classes). A função define o estado correto do módulo durante a criação da página.

Sintaxe

HRESULT MMCPropPageCallback(
  void *vpsp
);

Parâmetros

vpsp

Um ponteiro para a estrutura PROPSHEETPAGE do Microsoft Windows. Lembre-se de que, por padrão, o MFC instala seu próprio retorno de chamada no membro pfnCallback da estrutura.

Valor retornado

Essa função de retorno de chamada pode retornar um desses valores.

Comentários

Essa função não deve ser chamada por snap-ins que vinculam estaticamente bibliotecas MFC. Uma chamada para essa função por esse snap-in não será vinculada corretamente.

Para cada página derivada de CPropertyPage, chame MMCPropPageCallback com um ponteiro para o retorno de chamada da página, seguindo estas diretrizes:

• Todas as páginas de uma determinada folha de propriedades devem usar o mesmo ponteiro de retorno de chamada.
• Se você substituir o retorno de chamada do MFC pelo seu, seu retorno de chamada deverá chamar o retorno de chamada do MFC.
• Você deve chamar essa função com cada classe derivada de CPropertyPage .

O MFC deve ter o estado do módulo correto definido de funções exportadas ou interfaces COM. Isso inclui chamadas feitas do sistema operacional para o módulo. Para funções exportadas ou interfaces COM, isso é feito adicionando a macro AFX_MANAGE_STATE no início de todas as funções exportadas em DLLs snap-in que vinculam dinamicamente ao MFC. Isso é feito adicionando a seguinte linha de código ao início das funções exportadas do snap-in:

AFX_MANAGE_STATE(AfxGetStaticModuleState( ))

Para uma chamada do sistema operacional, o MFC faz isso automaticamente. Como a folha de propriedades do MMC não é uma CPropertySheet do MFC, a chamada do sistema operacional devido ao retorno de chamada está no estado errado do módulo. Como resultado, você precisa verificar se o estado do módulo está definido corretamente durante a criação da página. Essa é a finalidade de MMCPropPageCallback. Depois que o estado do módulo tiver sido definido, as únicas chamadas AFX_MANAGE_STATE que precisam ser feitas são aquelas expostas pelas interfaces COM implementadas pelo snap-in (por exemplo , IExtendPropertySheet2::CreatePropertyPages). Para determinar se o aplicativo tem o estado correto do módulo, examine CWinApp e anote o nome do aplicativo.

Requisitos

Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	mmc.h

Confira também

PROPSHEETPAGE