IWizardExtension::AddPages-Methode (shobjidl.h)

Artikel
08/26/2023

Fügt dem Assistenten Erweiterungsseiten hinzu, indem ein Array mit Handles zu PROPSHEETPAGE-Strukturen gefüllt wird, die diese Seiten darstellen.

Syntax

HRESULT AddPages(
  [out] HPROPSHEETPAGE *aPages,
  [in]  UINT           cPages,
  [out] UINT           *pnPagesAdded
);

Parameter

[out] aPages

Typ: HPROPSHEETPAGE*

Ein Zeiger auf ein Array von PROPSHEETPAGE-Handles , die die Dialogfeldseiten des Assistenten darstellen. Handles zu PROPSHEETPAGE-Strukturen für die Erweiterungsseiten werden diesem Array hinzugefügt.

[in] cPages

Typ: UINT

Die Anzahl der Elemente in aPages.

[out] pnPagesAdded

Typ: UINT*

Die Anzahl der erfolgreich hinzugefügten Handles.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Das Array von Handles, auf die von aPages verwiesen wird, kann Handles zu Assistentendialogseiten vor und nach den Erweiterungsseiten enthalten. Der Zeiger des Arrays sollte an diese Methode übergeben werden, sodass sein Wert das erste leere Arrayelement ist, das bereit ist, das Handle der ersten Erweiterungsseite anstelle des ersten Elements zu akzeptieren. Der in cPages übergebene Wert sollte die Anzahl der nicht verwendeten Arrayelemente anstelle der Gesamtanzahl angeben.

Wenn beispielsweise zwei einführende Hostseiten zu einem Array namens hpages hinzugefügt wurden, wird der Aufruf von IWizardExtension::AddPages wie folgt angezeigt.

#define ARRAYSIZE(a)    (sizeof(a)/sizeof(a[0]))
g_iwe->AddPages(&hpages[2], ARRAYSIZE(hpages)-2, &nPages);

Verwechseln Sie nicht Assistentenseiten, bei denen es sich um PROPSHEETPAGE-Strukturen handelt, mit gehosteten HTML-Seiten. Eine Dialogfeldseite des Assistenten kann viele sequenzielle HTML-Seiten hosten. Diese Methode stellt die Anzahl der Assistentendialogseiten bereit, die von der Assistentenerweiterung hinzugefügt werden, nicht die Anzahl der serverseitigen HTML-Seiten, die darin angezeigt werden.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl.h
DLL	Shell32.dll

Share via