Método ISpecifyPropertyPages::GetPages (ocidl.h)

  • Artículo

Recupera una lista de páginas de propiedades que se pueden mostrar en la hoja de propiedades de este objeto.

Sintaxis

HRESULT GetPages(
  [out] CAUUID *pPages
);

Parámetros

[out] pPages

Puntero a una estructura CAUUID asignada por el autor de la llamada que inicializa y rellena la función antes de que devuelva. El miembro pElems de la estructura se asigna mediante la función con CoTaskMemAlloc y el autor de la llamada debe liberarlo con CoTaskMemFree.

Valor devuelto

Este método puede devolver los valores devueltos estándar E_OUTOFMEMORY y E_UNEXPECTED, así como los valores siguientes.

Código devuelto Descripción
S_OK
 El método se completó correctamente.
E_POINTER
 La dirección de pPages no es válida. Por ejemplo, puede ser NULL.

Comentarios

La estructura CAUUID está asignada por el autor de la llamada, pero el autor de la llamada no la inicializa. El método GetPages rellena el miembro cElements en la estructura . Este método también asigna memoria para la matriz a la que apunta el miembro pElems mediante CoTaskMemAlloc. A continuación, rellena la matriz recién asignada. Una vez que este método se devuelve correctamente, la estructura contiene una matriz contada de UUID, cada UUID que especifica un CLSID de página de propiedades.

Notas a los autores de llamadas

El autor de la llamada debe liberar la memoria a la que apunta el miembro pElems de CAUUID, mediante CoTaskMemFree cuando ya no se necesite.

Notas para los implementadores

E_NOTIMPL no se permite como valor devuelto, porque un objeto sin páginas de propiedades no debe exponer la interfaz ISpecifyPropertyPages .

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ocidl.h

Consulte también

ISpecifyPropertyPages