Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gilt für: Outlook 2013 | Outlook 2016
Erstellt ein Lesezeichen an der aktuellen Position der Tabelle.
HRESULT CreateBookmark(
BOOKMARK FAR * lpbkPosition
);
Parameter
lpbkPosition
[out] Zeiger auf den zurückgegebenen 32-Bit-Lesezeichenwert. Dieses Lesezeichen kann später in einem Aufruf der IMAPITable::SeekRow-Methode übergeben werden.
Rückgabewert
S_OK
Der Aufruf erfolgreich ausgeführt und der erwartete Wert oder Werte zurückgegeben hat.
MAPI_E_UNABLE_TO_COMPLETE
Der angeforderte Vorgang konnte nicht abgeschlossen werden.
Hinweise
Die IMAPITable::CreateBookmark-Methode kennzeichnet eine Tabellenposition, indem sie einen Wert erstellt, der als Lesezeichen bezeichnet wird. Ein Lesezeichen kann verwendet werden, um zu der durch das Lesezeichen gekennzeichneten Position zurückzukehren. Die mit einem Lesezeichen versehene Position ist dem Objekt in dieser Zeile der Tabelle zugeordnet.
Lesezeichen werden in Anlagentabellen nicht unterstützt, und Anlagentabellenimplementierungen von CreateBookmark geben MAPI_E_NO_SUPPORT zurück.
Hinweise für Implementierer
Aufgrund der Arbeitsspeicherkosten für die Verwaltung von Cursorpositionen mit Lesezeichen sollten Sie die Anzahl der Lesezeichen begrenzen, die erstellt werden können. Wenn diese Anzahl erreicht wird, sollten alle nachfolgenden Aufrufe von CreateBookmark MAPI_E_UNABLE_TO_COMPLETE zurückgeben.
Manchmal verweist ein Lesezeichen auf eine Zeile, die sich nicht mehr in der Tabellenansicht befindet. Wenn ein Aufruf ein solches Lesezeichen verwendet, bewegen Sie den Cursor zur nächsten sichtbaren Zeile, und beenden Sie den Aufruf hier.
Wenn der Aufruf versucht, ein Lesezeichen zu verwenden, das auf eine reduzierte und daher nicht sichtbare Zeile zeigt, geben Sie nach dem Verschieben des Lesezeichens MAPI_W_POSITION_CHANGED zurück. Sie können das Lesezeichen entweder zu diesem Zeitpunkt oder beim Reduzieren in der SetCollapseState-Methode in der nächsten sichtbaren Zeile positionieren. Wenn Sie das Lesezeichen zum Zeitpunkt des Reduzierens der Zeile verschieben, müssen Sie ein Bit im Lesezeichen beibehalten, das genau angibt, wann das Lesezeichen verschoben wurde: seit seiner letzten Verwendung oder ob es seit seiner Erstellung nie verwendet wurde.
Hinweise für Aufrufer
CreateBookmark belegt Arbeitsspeicher für das von ihm erstellte Lesezeichen. Geben Sie die Ressourcen für das Lesezeichen frei, indem Sie die IMAPITable::FreeBookmark-Methode aufrufen.