ITableData::HrGetView
Gilt für: Outlook 2013 | Outlook 2016
Erstellt eine Tabellenansicht und gibt einen Zeiger auf eine IMAPITable-Implementierung zurück.
HRESULT HrGetView(
LPSSortOrderSet lpSSortOrderSet,
CALLERRELEASE FAR * lpfCallerRelease,
ULONG_PTR ulCallerData,
LPMAPITABLE FAR * lppMAPITable
);
Parameter
lpSSortOrderSet
[in] Ein Zeiger auf eine Sortierreihenfolgestruktur, die die Sortierreihenfolge für die Tabellenansicht beschreibt. Wenn NULL im lpSSortOrderSet-Parameter übergeben wird, wird die Ansicht nicht sortiert.
lpfCallerRelease
[in] Ein Zeiger auf eine Rückruffunktion, die auf dem CALLERRELEASE-Prototyp basiert, den MAPI aufruft, wenn die Ansicht freigegeben wird. Wenn NULL im lpfCallerRelease-Parameter übergeben wird, wird beim Freigeben der Ansicht keine Funktion aufgerufen.
ulCallerData
[in] Die Daten, die mit der neuen Ansicht gespeichert und an die Rückruffunktion übergeben werden müssen, auf die lpfCallerRelease verweist.
lppMAPITable
[out] Ein Zeiger auf einen Zeiger auf die neu erstellte Ansicht.
Rückgabewert
S_OK
Die Ansicht wurde erfolgreich erstellt.
Hinweise
Die ITableData::HrGetView-Methode erstellt eine schreibgeschützte Ansicht der Daten in der Tabelle, sortiert in der Reihenfolge, auf die der lpSSortOrderSet-Parameter verweist. Der Cursor wird am Anfang der ersten Zeile in der Ansicht platziert. Eine IMAPITable-Schnittstellenimplementierung für den Zugriff auf die Ansicht wird zurückgegeben.
Dienstanbieter rufen HrGetView auf, wenn sie einem Client Zugriff auf eine Tabelle gewähren müssen. HrGetView erstellt die Ansicht und gibt den IMAPITable-Zeiger zurück. Dienstanbieter übergeben wiederum den Zeiger an den Client. Wenn der Client die Verwendung der Tabelle abgeschlossen hat und seine IUnknown::Release-Methode aufruft, ruft HrGetView die Rückruffunktion auf, auf die der lpfCallerRelease-Parameter verweist.
Wenn ein Dienstanbieter eine Ansicht mit einem angepassten Spaltensatz oder einer Einschränkung an einen Client zurückgeben muss, kann der Anbieter die Methoden IMAPITable::SetColumns und IMAPITable::Restrict der Ansicht aufrufen, bevor er den Clientzugriff zulässt.