ITableData::HrGetView
Область применения: Outlook 2013 | Outlook 2016
Создает табличное представление, возвращая указатель на реализацию IMAPITable .
HRESULT HrGetView(
LPSSortOrderSet lpSSortOrderSet,
CALLERRELEASE FAR * lpfCallerRelease,
ULONG_PTR ulCallerData,
LPMAPITABLE FAR * lppMAPITable
);
Параметры
lpSSortOrderSet
[в] Указатель на структуру порядка сортировки, которая описывает порядок сортировки для табличного представления. Если значение NULL передается в параметре lpSSortOrderSet , представление не сортируется.
lpfCallerRelease
[в] Указатель на функцию обратного вызова на основе прототипа CALLERRELEASE , вызываемого MAPI при выпуске представления. Если в параметре lpfCallerRelease передается значение NULL, при выпуске представления функция не вызывается.
ulCallerData
[в] Данные, которые необходимо сохранить в новом представлении и передать в функцию обратного вызова, на которую указывает lpfCallerRelease.
lppMAPITable
[out] Указатель на указатель на только что созданное представление.
Возвращаемое значение
S_OK
Представление успешно создано.
Замечания
Метод ITableData::HrGetView создает доступное только для чтения представление данных в таблице, отсортированного в порядке, на который указывает параметр lpSSortOrderSet . Курсор помещается в начале первой строки представления. Возвращается реализация интерфейса IMAPITable для доступа к представлению.
Поставщики услуг вызывают HrGetView , когда им нужно предоставить клиенту доступ к таблице. HrGetView создает представление и возвращает указатель IMAPITable . Поставщики услуг, в свою очередь, передают указатель на клиент. Когда клиент завершает работу с таблицей и вызывает метод IUnknown::Release , HrGetView вызывает функцию обратного вызова, на которую указывает параметр lpfCallerRelease .
Если поставщик услуг должен вернуть клиенту представление с настраиваемым набором столбцов или ограничением, поставщик может вызвать методы IMAPITable::SetColumns и IMAPITable::Restrict представления, прежде чем разрешить доступ клиенту.