MMCPropPageCallback-Funktion (mmc.h)

Die MMCPropPageCallback-Funktion ist nur für MFC-basierte Snap-Ins (Microsoft Foundation Classes) erforderlich. Die Funktion legt den richtigen Modulzustand während der Seitenerstellung fest.

Syntax

HRESULT MMCPropPageCallback(
  void *vpsp
);

Parameter

vpsp

Ein Zeiger auf die Microsoft Windows PROPSHEETPAGE-Struktur . Beachten Sie, dass MFC standardmäßig einen eigenen Rückruf im pfnCallback-Member der Struktur installiert.

Rückgabewert

Diese Rückruffunktion kann einen dieser Werte zurückgeben.

Hinweise

Diese Funktion sollte nicht von Snap-Ins aufgerufen werden, die MFC-Bibliotheken statisch verknüpfen. Ein Aufruf dieser Funktion durch ein solches Snap-In wird nicht ordnungsgemäß verknüpft.

Rufen Sie für jede von CPropertyPage abgeleitete Seite MMCPropPageCallback mit einem Zeiger auf den Rückruf der Seite auf, und befolgen Sie die folgenden Richtlinien:

• Alle Seiten für ein bestimmtes Eigenschaftenblatt müssen denselben Rückrufzeiger verwenden.
• Wenn Sie den Rückruf von MFC durch Ihren eigenen ersetzen, muss Ihr Rückruf den Rückruf von MFC aufrufen.
• Sie müssen diese Funktion mit jeder abgeleiteten CPropertyPage-Klasse aufrufen.

Für MFC muss der richtige Modulstatus von exportierten Funktionen oder COM-Schnittstellen festgelegt sein. Dies schließt Aufrufe des Betriebssystems an das Modul ein. Für exportierte Funktionen oder COM-Schnittstellen erfolgt dies durch Hinzufügen des AFX_MANAGE_STATE Makros am Anfang aller exportierten Funktionen in Snap-In-DLLs, die dynamisch mit MFC verknüpft werden. Dazu fügen Sie die folgende Codezeile am Anfang der aus dem Snap-In exportierten Funktionen hinzu:

AFX_MANAGE_STATE(AfxGetStaticModuleState( ))

Bei einem Betriebssystemaufruf führt MFC dies automatisch aus. Da das MMC-Eigenschaftenblatt kein MFC CPropertySheet ist, befindet sich der Betriebssystemaufruf aufgrund des Rückrufs im falschen Modulzustand. Daher müssen Sie sicherstellen, dass der Modulstatus während der Seitenerstellung ordnungsgemäß festgelegt ist. Dies ist der Zweck von MMCPropPageCallback. Nachdem der Modulstatus festgelegt wurde, müssen nur AFX_MANAGE_STATE Aufrufe ausgeführt werden, die von den com-Schnittstellen verfügbar gemacht werden, die durch das Snap-In implementiert werden (z. B. IExtendPropertySheet2::CreatePropertyPages). Um zu ermitteln, ob die Anwendung den richtigen Modulstatus aufweist, sehen Sie sich CWinApp an, und notieren Sie sich den Anwendungsnamen.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	mmc.h

Weitere Informationen

PROPSHEETPAGE