Método IWizardExtension::AddPages (shobjidl.h)

Adiciona páginas de extensão ao assistente preenchendo uma matriz com identificadores para estruturas PROPSHEETPAGE que representam essas páginas.

Sintaxe

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

Parâmetros

[out] aPages

Tipo: HPROPSHEETPAGE*

Um ponteiro para uma matriz de identificadores PROPSHEETPAGE que representam as páginas de diálogo do assistente. Identificadores para estruturas PROPSHEETPAGE para as páginas de extensão são adicionados a essa matriz.

[in] cPages

Tipo: UINT

A contagem de elementos em aPages.

[out] pnPagesAdded

Tipo: UINT*

A contagem de identificadores adicionados com êxito.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

A matriz de identificadores apontada por aPages pode conter identificadores para páginas de diálogo do assistente anteriores e seguindo as páginas de extensão. O ponteiro da matriz deve ser passado para esse método para que seu valor seja o primeiro elemento de matriz vazio, pronto para aceitar o identificador da primeira página de extensão, em vez de simplesmente o primeiro elemento. Como garantia, o valor passado em cPages deve declarar o número de elementos de matriz não utilizados em vez do número total.

Por exemplo, se duas páginas de host introdutórias foram adicionadas a uma matriz chamada hpages, a chamada para IWizardExtension::AddPages aparecerá da seguinte maneira.

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

Não confunda páginas do assistente, que são estruturas PROPSHEETPAGE , com páginas HTML hospedadas. Uma página de diálogo do assistente pode hospedar muitas páginas HTML sequenciais. Esse método fornece o número de páginas de diálogo do assistente adicionadas pela extensão do assistente, não o número de páginas HTML do lado do servidor que são exibidas nela.

Requisitos