CALLERRELEASE

Aplica-se a: Outlook 2013 | Outlook 2016

Define uma função de retorno de chamada que pode liberar um objeto de dados de tabela quando uma exibição de tabela está sendo lançada.

Propriedade	Valor
Arquivo de cabeçalho:	Mapiutil.h
Função definida implementada por:	Aplicativos cliente e provedores de serviços
Função definida chamada por:	MAPI

void CALLERRELEASE(
  ULONG_PTR ulCallerData,
  LPTABLEDATA lpTblData,
  LPMAPITABLE lpVue
);

Parâmetros

ulCallerData

[in] Dados de chamador salvos pelo MAPI com o modo de exibição de tabela e passados para a função de retorno de chamada baseada em CALLERRELEASE . Os dados fornecem contexto sobre a exibição da tabela que está sendo liberada.

lpTblData

[in] Ponteiro para a interface ITableData : IUnknown para o objeto de dados de tabela subjacente à exibição da tabela que está sendo lançada.

lpVue

[in] Ponteiro para a interface IMAPITable : IUnknown para o modo de exibição de tabela que está sendo lançado. Esta é uma interface para o objeto table retornado no parâmetro lppMAPITable do método ITableData::HrGetView que criou o objeto a ser lançado.

Valor de retorno

Nenhum

Comentários

Um aplicativo cliente ou provedor de serviços que tenha preenchido um objeto de dados de tabela pode chamar ITableData::HrGetView para criar uma exibição classificada e somente leitura da tabela. A chamada para HrGetView passa um ponteiro para uma função de retorno de chamada baseada em CALLERRELEASE e também um contexto a ser salvo com o modo de exibição de tabela. Quando a contagem de referência do modo de exibição de tabela retorna a zero e a exibição está sendo liberada, a implementação IMAPITable chama a função de retorno de chamada, passando o contexto no parâmetro ulCallerData .

Um uso comum de uma função de retorno de chamada baseada em CALLERRELEASE é liberar o objeto de dados da tabela subjacente e não precisar controlar isso durante o processamento subsequente.