IWPSiteW::AddWizardPages Method

---

Allows the provider DLLs to plug pages into the wizard invoked by the WpPost function.

Syntax

HRESULT AddWizardPages(
    LPVOID pvFlags,
    LPFNADDPROPSHEETPAGE pfnAdd,
    LPARAM pParam
);

Parameters

pvFlags

Address of a LONG containing action flags. This parameter must be cast to an LPVOID in the call to AddWizardPages for compatibility. The only flag value supported is WPF_SHOWPAGE_PROVIDER, which indicates that the service provider should add its pages to the wizard whether or not it thinks that they are required.

pfnAdd

Address of a function that this Web Publishing service provider should use to add wizard pages. The declaration of this function-pointer type (LPFNADDPROPSHEETPAGE), is included in the header files of the Win32® SDK.

pParam

Address of a page identifier, an unsigned integer.

Return Value

Returns S_OK if successful, or an error code otherwise.

Remarks

As input to this function, the low-order word is the dialog box identifier of the page after the last page of the provider, and the high-order word is the dialog box identifier of the page before the first page of the provider.

As output from this function, the low-order word is the dialog box identifier of the provider's last page, and the high-order word is the dialog box identifier of the provider's first page. If the provider has no pages, it should return zero as the page identifier.

As an example, in setting up a new site the wizard would provide the friendly site name, and the site's URL and the provider DLLs would handle the rest of the site setup. The dialog box identifier of the provider wizard page should be a value between the values of IDD_FIRST_PROV_PAGE and IDD_LAST_PROV_PAGE, as defined in the file Wppdefs.h included with the stubbed service provider among the SDK samples.