IWizardExtension：：AddPages 方法 (shobjidl.h)

通过使用表示这些页面的 PROPSHEETPAGE 结构的句柄填充数组，将扩展页添加到向导。

语法

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

[out] aPages

类型： HPROPSHEETPAGE*

指向表示向导对话框页的 PROPSHEETPAGE 句柄数组的指针。扩展页 的 PROPSHEETPAGE 结构的句柄将添加到此数组中。

[in] cPages

类型： UINT

aPages 中的元素计数。

[out] pnPagesAdded

类型： UINT*

已成功添加句柄的计数。

类型： HRESULT

如果该方法成功，则返回 S_OK。否则，将返回 HRESULT 错误代码。

aPages 指向的句柄数组可以包含扩展页之前和之后的向导对话框页的句柄。数组的指针应传递给此方法，以便其值为第一个空数组元素，该元素已准备好接受第一个扩展页的句柄，而不仅仅是第一个元素。在 cPages 中传递的值应说明未使用的数组元素的数量，而不是总数。

例如，如果将两个介绍性主机页添加到名为 hpages 的数组中，则对 IWizardExtension：：AddPages 的 调用将如下所示。

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

不要将属于 PROPSHEETPAGE 结构的向导页与托管的 HTML 页混淆。一个向导对话框页可以承载多个连续的 HTML 页面。此方法提供向导扩展添加的向导对话框页数，而不是其中显示的服务器端 HTML 页数。