Funzione MMCPropPageCallback (mmc.h)

La funzione MMCPropPageCallback è richiesta solo dagli snap-in basati su Microsoft Foundation Classes (MFC). La funzione imposta lo stato corretto del modulo durante la creazione della pagina.

Sintassi

HRESULT MMCPropPageCallback(
  void *vpsp
);

Parametri

vpsp

Puntatore alla struttura Microsoft Windows PROPSHEETPAGE . Tenere presente che per impostazione predefinita, MFC installa il callback nel membro pfnCallback della struttura.

Valore restituito

Questa funzione di callback può restituire uno di questi valori.

Commenti

Questa funzione non deve essere chiamata dagli snap-in che collegano staticamente le librerie MFC. Una chiamata a questa funzione da tale snap-in non collega correttamente.

Per ogni pagina derivata da CPropertyPage, chiamare MMCPropPageCallback con un puntatore al callback della pagina, seguendo queste linee guida:

• Tutte le pagine per un foglio di proprietà specifico devono usare lo stesso puntatore di callback.
• Se si sostituisce il callback di MFC con il proprio, il callback deve chiamare il callback di MFC.
• È necessario chiamare questa funzione con ogni classe derivata CPropertyPage .

MFC deve avere il set di stato del modulo corretto da funzioni esportate o interfacce COM. Sono incluse le chiamate effettuate dal sistema operativo al modulo. Per le funzioni esportate o le interfacce COM, questa operazione viene eseguita aggiungendo la macro AFX_MANAGE_STATE all'inizio di tutte le funzioni esportate nelle DLL snap-in che collegano dinamicamente a MFC. Questa operazione viene eseguita aggiungendo la riga di codice seguente all'inizio delle funzioni esportate dallo snap-in:

AFX_MANAGE_STATE(AfxGetStaticModuleState( ))

Per una chiamata del sistema operativo, MFC esegue automaticamente questa operazione. Poiché il foglio delle proprietà di MMC non è un foglio di proprietà MFC CPropertySheet, la chiamata del sistema operativo a causa del callback è nello stato del modulo errato. Di conseguenza, è necessario assicurarsi che lo stato del modulo sia impostato correttamente durante la creazione della pagina. Questo è lo scopo di MMCPropPageCallback. Dopo aver impostato lo stato del modulo, l'unico AFX_MANAGE_STATE chiamate che devono essere effettuate sono quelle esposte dalle interfacce COM implementate dallo snap-in (ad esempio IExtendPropertySheet2::CreatePropertyPages). Per determinare se l'applicazione ha lo stato del modulo corretto, esaminare CWinApp e prendere nota del nome dell'applicazione.

Requisiti

Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	mmc.h

Vedi anche

PROPSHEETPAGE