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

  • Artigo

Recupera uma lista de páginas de propriedades que podem ser exibidas na folha de propriedades deste objeto.

Sintaxe

HRESULT GetPages(
  [out] CAUUID *pPages
);

Parâmetros

[out] pPages

Um ponteiro para uma estrutura CAUUID alocada pelo chamador que a função inicializa e preenche antes de retornar. O membro pElems na estrutura é alocado pela função com CoTaskMemAlloc e deve ser liberado pelo chamador com CoTaskMemFree.

Retornar valor

Esse método pode retornar os valores retornados padrão E_OUTOFMEMORY e E_UNEXPECTED, bem como os valores a seguir.

Código de retorno Descrição
S_OK
 O método foi concluído com sucesso.
E_POINTER
 O endereço em pPages não é válido. Por exemplo, pode ser NULL.

Comentários

A estrutura CAUUID é alocada pelo chamador, mas não é inicializada pelo chamador. O método GetPages preenche o membro cElements na estrutura . Esse método também aloca memória para a matriz apontada pelo membro pElems usando CoTaskMemAlloc. Em seguida, ele preenche a matriz recém-alocada. Depois que esse método retorna com êxito, a estrutura contém uma matriz contada de UUIDs, cada UUID especificando uma página de propriedades CLSID.

Anotações aos Chamadores

O chamador deve liberar a memória apontada pelo membro pElems do CAUUID, usando CoTaskMemFree quando não for mais necessário.

Observações aos implementadores

E_NOTIMPL não é permitido como um valor retornado, pois um objeto sem páginas de propriedades não deve expor a interface ISpecifyPropertyPages .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ocidl.h

Confira também

Ispecifypropertypages