IMAPITable::CreateBookmark
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 markiert eine Tabellenposition, indem ein Wert erstellt wird, der als Lesezeichen bezeichnet wird. Ein Lesezeichen kann verwendet werden, um zu der position zurückzukehren, die durch das Lesezeichen identifiziert wird. Die mit Einem Lesezeichen versehene Position ist dem -Objekt in dieser Zeile in der Tabelle zugeordnet.
Lesezeichen werden für 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 können Sie die Anzahl der Lesezeichen begrenzen, die Sie erstellen können. Wenn Sie diese Nummer erreichen, geben Sie MAPI_E_UNABLE_TO_COMPLETE von allen nachfolgenden Aufrufen von CreateBookmark zurück.
Manchmal verweist ein Lesezeichen auf eine Zeile, die sich nicht mehr in der Tabellenansicht befindet. Wenn ein Aufrufer eine solche Textmarke verwendet, bewegen Sie den Cursor in die nächste sichtbare Zeile, und halten Sie dort an.
Wenn der Aufrufer versucht, ein Lesezeichen zu verwenden, das auf eine nicht sichtbare Zeile verweist, da diese reduziert wurde, 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 neu positionieren. Wenn Sie das Lesezeichen zu dem Zeitpunkt verschieben, zu dem die Zeile reduziert wird, müssen Sie ein Bit im Lesezeichen beibehalten, das genau angibt, wann das Lesezeichen verschoben wurde: seit seiner letzten Verwendung oder wenn es seit seiner Erstellung nie verwendet wurde.
Hinweise für Aufrufer
CreateBookmark belegt Arbeitsspeicher für das erstellte Lesezeichen. Geben Sie die Ressourcen für das Lesezeichen frei, indem Sie die IMAPITable::FreeBookmark-Methode aufrufen.