MMCPropPageCallback, fonction (mmc.h)

La fonction MMCPropPageCallback est uniquement requise par les composants logiciels enfichables basés sur MFC (Microsoft Foundation Classes). La fonction définit l’état correct du module lors de la création de la page.

Syntaxe

HRESULT MMCPropPageCallback(
  void *vpsp
);

Paramètres

vpsp

Pointeur vers la structure Microsoft Windows PROPSHEETPAGE . N’oubliez pas que par défaut, MFC installe son propre rappel dans le membre pfnCallback de la structure.

Valeur retournée

Cette fonction de rappel peut retourner l’une de ces valeurs.

Notes

Cette fonction ne doit pas être appelée par des composants logiciels enfichables qui lient statiquement des bibliothèques MFC. Un appel à cette fonction par un tel composant logiciel enfichable ne sera pas lié correctement.

Pour chaque page dérivée de CPropertyPage, appelez MMCPropPageCallback avec un pointeur vers le rappel de la page, en suivant ces instructions :

• Toutes les pages d’une feuille de propriétés particulière doivent utiliser le même pointeur de rappel.
• Si vous remplacez le rappel de MFC par le vôtre, votre rappel doit appeler le rappel de MFC.
• Vous devez appeler cette fonction avec chaque classe dérivée CPropertyPage .

MFC doit avoir l’état de module correct défini à partir des fonctions exportées ou des interfaces COM. Cela inclut les appels effectués à partir du système d’exploitation vers le module. Pour les fonctions exportées ou les interfaces COM, cela s’effectue en ajoutant la macro AFX_MANAGE_STATE au début de toutes les fonctions exportées dans les DLL enfichables qui sont liées dynamiquement à MFC. Pour ce faire, ajoutez la ligne de code suivante au début des fonctions exportées à partir du composant logiciel enfichable :

AFX_MANAGE_STATE(AfxGetStaticModuleState( ))

Pour un appel de système d’exploitation, MFC effectue cette opération automatiquement. Étant donné que la feuille de propriétés de MMC n’est pas une feuille CPropertySheet MFC, l’appel du système d’exploitation en raison du rappel est dans un état de module incorrect. Par conséquent, vous devez vous assurer que l’état du module est correctement défini lors de la création de la page. C’est l’objectif de MMCPropPageCallback. Une fois l’état du module défini, les seuls appels AFX_MANAGE_STATE qui doivent être effectués sont ceux exposés par les interfaces COM implémentées par le composant logiciel enfichable (par exemple IExtendPropertySheet2::CreatePropertyPages). Pour déterminer si l’application a l’état de module correct, examinez CWinApp et notez le nom de l’application.

Spécifications

Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	mmc.h

Voir aussi

PROPSHEETPAGE