共用方式為

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 頁面數目。

需求

   
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 shobjidl.h
Dll Shell32.dll