共用方式為


ITableData::HrGetView

適用於:Outlook 2013 |Outlook 2016

建立數據表檢視,並傳回 IMAPITable 實作的指標。

HRESULT HrGetView(
  LPSSortOrderSet lpSSortOrderSet,
  CALLERRELEASE FAR * lpfCallerRelease,
  ULONG_PTR ulCallerData,
  LPMAPITABLE FAR * lppMAPITable
);

參數

lpSSortOrderSet

[in]排序順序結構的指標,描述數據表檢視的排序順序。 如果在 lpSSortOrderSet 參數中傳遞 NULL,則不會排序檢視。

lpfCallerRelease

[in]以MAPI在釋放檢視時呼叫 之 CALLERRELEASE 原型為基礎的回調函式指標。 如果在 lpfCallerRelease 參數中傳遞 NULL,則不會在檢視版本上呼叫任何函式。

ulCallerData

[in]必須以新檢視儲存並傳遞至 lpfCallerRelease 所指向之回調函式的數據。

lppMAPITable

[out]新建立之檢視指標的指標。

傳回值

S_OK

已成功建立檢視。

註解

ITableData::HrGetView 方法會建立數據表中數據的只讀檢視,並依照 lpSSortOrderSet 參數所指向的順序排序。 游標會放在檢視中第一列的開頭。 會傳回用於存取檢視的 IMAPITable 介面實作。

當服務提供者需要授與客戶端對數據表的存取權時,會呼叫 HrGetViewHrGetView 會建立檢視並傳回 IMAPITable 指標。 服務提供者接著會將指標傳遞至用戶端。 當用戶端使用數據表並呼叫其 IUnknown::Release 方法時, HrGetView 會呼叫 lpfCallerRelease 參數所指向的回調函式。

如果服務提供者需要將具有自定義數據行集或限制的檢視傳回給用戶端,則提供者可以先呼叫檢視的 IMAPITable::SetColumnsIMAPITable::Restrict 方法,再允許用戶端存取。

另請參閱

CALLERRELEASE

IMAPITable:IUnknown

SSortOrderSet

ITableData:IUnknown