Compartir a través de

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

  • Artículo

Agrega páginas de extensión al asistente rellenando una matriz con identificadores a estructuras PROPSHEETPAGE que representan esas páginas.

Sintaxis

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

Parámetros

[out] aPages

Tipo: HPROPSHEETPAGE*

Puntero a una matriz de identificadores PROPSHEETPAGE que representan las páginas del cuadro de diálogo del asistente. Los identificadores de las estructuras PROPSHEETPAGE de las páginas de extensión se agregan a esta matriz.

[in] cPages

Tipo: UINT

Recuento de elementos de aPages.

[out] pnPagesAdded

Tipo: UINT*

Recuento de identificadores agregados correctamente.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

La matriz de identificadores a los que apunta a aPages puede contener identificadores para las páginas de diálogo del asistente anteriores y después de las páginas de extensión. El puntero de la matriz debe pasarse a este método para que su valor sea el primer elemento de matriz vacío, listo para aceptar el identificador de la primera página de extensión, en lugar de simplemente el primer elemento. De forma secundaria, el valor pasado en cPages debe indicar el número de elementos de matriz sin usar en lugar del número total.

Por ejemplo, si se agregaron dos páginas host introductorias a una matriz denominada hpages, la llamada a IWizardExtension::AddPages aparecería como se indica a continuación.

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

No confunda las páginas del asistente, que son estructuras PROPSHEETPAGE , con páginas HTML hospedadas. Una página de diálogo del asistente puede hospedar muchas páginas HTML secuenciales. Este método proporciona el número de páginas de diálogo del asistente agregadas por la extensión del asistente, no el número de páginas HTML del lado servidor que se muestran en él.

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl.h
Archivo DLL Shell32.dll