IPropertySheetProvider::Show-Methode (mmc.h)

  • Artikel

Wenn der in IPropertySheetProvider::CreatePropertySheet festgelegte Typ ein Eigenschaftenblatt ist, zeigt IPropertySheetProvider::Show einen Eigenschaftenblattrahmen an, der einem ausgeblendeten Fenster zugeordnet ist. Wenn der in IPropertySheetProvider::CreatePropertySheet festgelegte Typ ein Assistent ist, zeigt IPropertySheetProvider::Show einen Eigenschaftenblattrahmen an, der dem Handle zugeordnet ist, das an diese Methode übergeben wird.

Syntax

HRESULT Show(
  [in] LONG_PTR window,
  [in] int      page
);

Parameter

[in] window

Ein Wert, der das Handle für das übergeordnete Fenster angibt.

[in] page

Ein Wert, der angibt, welche Seite auf dem Eigenschaftenblatt angezeigt wird. Es ist null indiziert.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Hinweise

IPropertySheetProvider::Show( –1, 0) gibt E_FAIL zurück. Dieser Rückgabecode kann in diesem Fall ignoriert werden.

In Situationen, in denen das Snap-In ein Eigenschaftenblatt in einem Aufruf von IPropertySheetProvider::CreatePropertySheet, optional IPropertySheetProvider::AddPrimaryPages und IPropertySheetProvider::AddExtensionPages erstellt und dann beschließt, das Eigenschaftenblatt nicht anzuzeigen, sollte es IPropertySheetProvider::Show( –1, 0) aufrufen, um das Eigenschaftenblatt zu löschen und seine Ressourcen freizugeben. In diesem Fall muss das Snap-In die von ihr erstellten Eigenschaftenseitenhandles löschen. Dies kann vor oder nach dem Aufruf von IPropertySheetProvider::Show( –1, 0) erfolgen, da MMC die Eigenschaftenseitenhandles nicht verwendet.

IPropertySheetProvider::Show( –1, 0) löscht nur das aktuelle Eigenschaftenblatt, d. h. eines, das erstellt wurde, aber noch nicht angezeigt wird. Nachdem ein Eigenschaftenblatt angezeigt wurde, kann es vom Snap-In nicht programmgesteuert geschlossen werden. Nur der Benutzer kann ein angezeigtes Eigenschaftenblatt schließen. In diesem Fall löscht MMC automatisch alle zugeordneten Eigenschaftenseiten (PROPSHEETPAGE-Strukturen ), die vom Snap-In bereitgestellt werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile mmc.h
DLL Mmcndmgr.dll

Weitere Informationen

IPropertySheetProvider