CreateTable
Aplica-se a: Outlook 2013 | Outlook 2016
Cria estruturas e um identificador de objeto para um objeto ITableData que pode ser usado para criar conteúdo de tabela.
| Propriedade | Valor |
|---|---|
| Arquivo de cabeçalho: |
Mapiutil.h |
| Implementado por: |
MAPI |
| Chamado por: |
Aplicativos cliente e provedores de serviços |
SCODE CreateTable(
LPCIID lpInterface,
ALLOCATEBUFFER FAR * lpAllocateBuffer,
ALLOCATEMORE FAR * lpAllocateMore,
FREEBUFFER FAR * lpFreeBuffer,
LPVOID lpvReserved,
ULONG ulTableType,
ULONG ulPropTagIndexColumn,
LPSPropTagArray lpSPropTagArrayColumns,
LPTABLEDATA FAR * lppTableData
);
Parâmetros
lpInterface
[in] Ponteiro para um IID (identificador de interface) para o objeto de dados da tabela. O identificador de interface válido é IID_IMAPITableData. Passar NULL no parâmetro lpInterface também faz com que o objeto de dados de tabela retornado no parâmetro lppTableData seja lançado para a interface padrão de um objeto de dados de tabela.
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.
lpvReserved
[in] Reservados; deve ser zero.
ulTableType
[in] Um tipo de tabela que está disponível para um aplicativo cliente ou provedor de serviços como parte da IMAPITable::GetStatus retornar dados em suas exibições de tabela. Os valores possíveis são:
TBLTYPE_DYNAMIC
O conteúdo da tabela é dinâmico e pode ser alterado conforme os dados subjacentes são alterados.
TBLTYPE_KEYSET
As linhas na tabela são fixas, mas os valores nessas linhas são dinâmicos e podem ser alterados conforme os dados subjacentes são alterados.
TBLTYPE_SNAPSHOT
A tabela é estática e o conteúdo não é alterado quando os dados subjacentes são alterados.
ulPropTagIndexColumn
[in] Número de índice da coluna para uso ao alterar dados da tabela.
lpSPropTagArrayColumns
[in] Ponteiro para uma estrutura SPropTagArray que contém uma matriz de marcas de propriedade indicando as propriedades necessárias na tabela para a qual o objeto contém dados.
lppTableData
[out] Ponteiro para um ponteiro para o objeto de dados de tabela retornado.
Valor de retorno
S_OK
A chamada foi bem-sucedida e retornou o valor ou valores esperados.
Comentários
Os parâmetros de entrada lpAllocateBuffer, lpAllocateMore e lpFreeBuffer apontam para as funções MAPIAllocateBuffer, MAPIAllocateMore e MAPIFreeBuffer , respectivamente. Um aplicativo cliente que chama CreateTable passa ponteiros para as funções MAPI nomeadas; um provedor de serviços passa os ponteiros para essas funções recebidas em sua chamada de inicialização ou recuperadas com uma chamada para o método IMAPISupport::GetMemAllocRoutines .