ITableData::HrGetView
Aplica-se a: Outlook 2013 | Outlook 2016
Cria uma exibição de tabela, retornando um ponteiro para uma implementação IMAPITable .
HRESULT HrGetView(
LPSSortOrderSet lpSSortOrderSet,
CALLERRELEASE FAR * lpfCallerRelease,
ULONG_PTR ulCallerData,
LPMAPITABLE FAR * lppMAPITable
);
Parâmetros
lpSSortOrderSet
[in] Um ponteiro para uma estrutura de ordem de classificação que descreve a ordem de classificação para a exibição da tabela. Se NULL for passado no parâmetro lpSSortOrderSet , a exibição não será classificada.
lpfCallerRelease
[in] Um ponteiro para uma função de retorno de chamada com base no protótipo CALLERRELEASE que MAPI chama quando ele libera o modo de exibição. Se NULL for passado no parâmetro lpfCallerRelease , nenhuma função será chamada na versão do modo de exibição.
ulCallerData
[in] Os dados que devem ser salvos com o novo modo de exibição e passados para a função de retorno de chamada apontada por lpfCallerRelease.
lppMAPITable
[out] Um ponteiro para um ponteiro para a exibição recém-criada.
Valor de retorno
S_OK
A exibição foi criada com êxito.
Comentários
O método ITableData::HrGetView cria uma exibição somente leitura dos dados na tabela, classificada na ordem apontada pelo parâmetro lpSSortOrderSet . O cursor é colocado no início da primeira linha no modo de exibição. Uma implementação de interface IMAPITable para acessar o modo de exibição é retornada.
Os provedores de serviços chamam HrGetView quando precisam dar a um cliente acesso a uma tabela. HrGetView cria a exibição e retorna o ponteiro IMAPITable . Os provedores de serviço, por sua vez, passam o ponteiro para o cliente. Quando o cliente terminar de usar a tabela e chamar seu método IUnknown::Release , o HrGetView chama a função de retorno de chamada apontada pelo parâmetro lpfCallerRelease .
Se um provedor de serviços precisar retornar a um cliente uma exibição que tenha um conjunto de colunas personalizado ou uma restrição, o provedor poderá chamar os métodos IMAPITable::SetColumns e IMAPITable::Restrict antes de permitir o acesso do cliente.