IMAPITable::CreateBookmark
Hace referencia a: Outlook 2013 | Outlook 2016
Crea un marcador en la posición actual de la tabla.
HRESULT CreateBookmark(
BOOKMARK FAR * lpbkPosition
);
Parameters
lpbkPosition
[out] Puntero al valor de marcador de 32 bits devuelto. Este marcador se puede pasar más adelante en una llamada al método IMAPITable::SeekRow .
Valor devuelto
S_OK
La llamada se ha realizado correctamente y devuelva el valor esperado o los valores.
MAPI_E_UNABLE_TO_COMPLETE
No se pudo completar la operación solicitada.
Comentarios
El método IMAPITable::CreateBookmark marca una posición de tabla mediante la creación de un valor denominado marcador. Se puede usar un marcador para volver a la posición identificada por el marcador. La posición marcada está asociada al objeto de esa fila de la tabla.
Los marcadores no se admiten en las tablas de datos adjuntos y las implementaciones de tablas de datos adjuntos de CreateBookmark devuelven MAPI_E_NO_SUPPORT.
Notas a los implementadores
Debido al gasto de memoria de mantener las posiciones del cursor con marcadores, limite el número de marcadores que puede crear. Cuando alcance ese número, devuelva MAPI_E_UNABLE_TO_COMPLETE de todas las llamadas posteriores a CreateBookmark.
A veces, un marcador apunta a una fila que ya no está en la vista de tabla. Si un llamador usa este marcador, mueva el cursor a la siguiente fila visible y deténgase allí.
Cuando el autor de la llamada intenta usar un marcador que apunta a una fila novisible porque se ha contraído, devuelve MAPI_W_POSITION_CHANGED después de mover el marcador. Puede cambiar la posición del marcador a la siguiente fila visible en este momento o cuando se produzca la contracción en el método SetCollapseState . Si mueve el marcador en el momento en que se contrae la fila, debe conservar un poco en el marcador que indique exactamente cuándo se movió el marcador: desde su último uso o si nunca se ha usado desde su creación.
Notas para los llamadores
CreateBookmark asigna memoria para el marcador que crea. Libere los recursos del marcador llamando al método IMAPITable::FreeBookmark .