BuildDisplayTable

Aplica-se a: Outlook 2013 | Outlook 2016

Cria uma tabela de exibição a partir dos dados da página de propriedade contidos em uma ou mais estruturas DTPAGE .

Propriedade	Valor
Arquivo de cabeçalho:	Mapiutil.h
Implementado por:	MAPI
Chamado por:	Provedores de serviços

STDAPI BuildDisplayTable(
  LPALLOCATEBUFFER lpAllocateBuffer,
  LPALLOCATEMORE lpAllocateMore,
  LPFREEBUFFER lpFreeBuffer,
  LPMALLOC lpMalloc,
  HINSTANCE hInstance,
  UINT cPages,
  LPDTPAGE lpPage,
  ULONG ulFlags,
  LPMAPITABLE * lppTable,
  LPTABLEDATA * lppTblData
);

Parâmetros

lpAllocateBuffer

[in] Ponteiro para a função MAPIAllocateBuffer , a ser usada para alocar memória.

lpAllocateMore

[in] Ponteiro para a função MAPIAllocateMore , a ser usada para alocar memória adicional.

lpFreeBuffer

[in] Ponteiro para a função MAPIFreeBuffer , a ser usada para liberar memória.

lpMalloc

Utilizadas; deve ser definido como NULL.

Hinstance

[in] Uma instância de um objeto MAPI do qual BuildDisplayTable recupera recursos.

cPages

[in] Contagem de estruturas DTPAGE na matriz apontada pelo parâmetro lpPage .

lpPage

[in] Ponteiro para uma matriz de estruturas DTPAGE que contêm informações sobre as páginas da tabela de exibição a serem criadas.

ulFlags

[in] Máscara de bits de sinalizadores. O seguinte sinalizador pode ser definido:

MAPI_UNICODE

As cadeias de caracteres passadas estão no formato Unicode. Se o sinalizador MAPI_UNICODE não estiver definido, as cadeias de caracteres estarão no formato ANSI.

lppTable

[out] Ponteiro para um ponteiro para a tabela de exibição, que expõe a interface IMAPITable .

lppTblData

[in, out] Ponteiro para um ponteiro para um objeto de dados de tabela expondo a interface ITableData na tabela retornada no parâmetro lppTable . Se nenhum objeto de dados de tabela for desejado, lppTblData deverá ser definido como NULL em vez de um valor de ponteiro.

Valor de retorno

Nenhum

Comentários

O MAPI usa as funções apontadas por lpAllocateBuffer, lpAllocateMore e lpFreeBuffer para a maioria da alocação e alocação de memória, em particular para alocar memória para uso por aplicativos cliente ao chamar interfaces de objeto como IMAPIProp::GetProps e IMAPITable::QueryRows.

Notas para chamadores

Tudo o que é possível é lido no recurso de caixa de diálogo, incluindo:

• O título da página que é, o membro ulbLpszLabel da estrutura DTBLPAGE lido no título da caixa de diálogo no recurso.

• Todos os títulos de controle que são, os membros ulbLpszLabel de outras estruturas de controle lidos do texto de controle no recurso.

BuildDisplayTable substitui qualquer coisa passada nas estruturas de controle de entrada com informações do recurso de caixa de diálogo, o que significa que o chamador do BuildDisplayTable não pode especificar dinamicamente títulos de página ou controle. Os chamadores que precisam fazer isso podem ter BuildDisplayTable retornar o objeto de dados de tabela em lppTableData e alterar linhas nele; ou eles podem criar a tabela de exibição manualmente em um objeto de dados de tabela.

Se lppTableData não estiver definido como NULL, o provedor será responsável por liberar o objeto de dados da tabela quando ele for concluído com a tabela de exibição.