IPropertySheetCallback::AddPage-Methode (mmc.h)

Die IPropertySheetCallback::AddPage-Methode ermöglicht einem Snap-In das Hinzufügen einer Seite zu einem Eigenschaftenblatt.

Syntax

HRESULT AddPage(
  [in] HPROPSHEETPAGE hPage
);

Parameter

[in] hPage

Ein Wert, der das Handle der hinzuzufügenden Seite angibt. Der hPage-Parameter ist ein Handle für eine PROPSHEETPAGE-Struktur , die von der Windows-API CreatePropertySheetPage erstellt wurde.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Hinweise

Das Snap-In kann AddPage nicht innerhalb eines Eigenschaftenseitenhandlers aufrufen, da die Eigenschaftenseite erstellt und in einem sekundären Thread ausgeführt wird. Ein Snap-In kann keine MMC-Schnittstelle aus einem anderen Thread als dem aufrufen, in dem das Snap-In erstellt wurde. Der richtige Ort zum Aufrufen von AddPage befindet sich in der Implementierung der IExtendPropertySheet2::CreatePropertyPages-Methode des Snap-Ins.

Wenn ein Snap-In die IPropertySheetProvider-Schnittstelle direkt verwendet, kann addPage die primären Seiten hinzufügen und dann IPropertySheetProvider::AddPrimaryPages (NULL, FALSE, NULL, [TRUE oder FALSE]) aufrufen, damit der Anbieter diese Seiten dem Eigenschaftenblatt hinzu fügt. Weitere Informationen zum Erstellen Ihrer Eigenschaftenseiten in der Implementierung von IExtendPropertySheet2::CreatePropertyPages des Snap-Ins finden Sie unter IPropertySheetProvider::AddPrimaryPages.

Seiten werden dem Blatt in der Reihenfolge hinzugefügt, in der sie angezeigt werden. Die Seiten des primären Snap-Ins werden immer zuerst hinzugefügt.

Anforderungen

Weitere Informationen

Ipropertysheetcallback