IMAPITable::CreateBookmark
Aplica-se a: Outlook 2013 | Outlook 2016
Cria um indicador na posição atual da tabela.
HRESULT CreateBookmark(
BOOKMARK FAR * lpbkPosition
);
Parâmetros
lpbkPosition
[out] Ponteiro para o valor de indicador retornado de 32 bits. Esse indicador pode ser passado posteriormente em uma chamada para o método IMAPITable::SeekRow .
Valor de retorno
S_OK
A chamada foi bem-sucedida e retornou o valor ou valores esperados.
MAPI_E_UNABLE_TO_COMPLETE
A operação solicitada não pôde ser concluída.
Comentários
O método IMAPITable::CreateBookmark marca uma posição de tabela criando um valor chamado indicador. Um indicador pode ser usado para retornar à posição identificada pelo indicador. A posição marcada está associada ao objeto nessa linha na tabela.
Não há suporte para indicadores em tabelas de anexo e implementações de tabela de anexo do createBookmark return MAPI_E_NO_SUPPORT.
Observações para implementadores
Devido à despesa de memória de manter posições de cursor com indicadores, limite o número de indicadores que você pode criar. Ao alcançar esse número, retorne MAPI_E_UNABLE_TO_COMPLETE de todas as chamadas subsequentes para CreateBookmark.
Às vezes, um indicador aponta para uma linha que não está mais na exibição da tabela. Se um chamador usar esse indicador, mova o cursor para a próxima linha visível e pare por aí.
Quando o chamador tentar usar um indicador que esteja apontando para uma linha não visual porque ela foi recolhida, retorne MAPI_W_POSITION_CHANGED depois de mover o indicador. Você pode reposicionar o indicador para a próxima linha visível neste momento ou quando o colapso ocorrer no método SetCollapseState . Se você mover o indicador no momento em que a linha é recolhida, você deve manter um pouco no indicador que indica exatamente quando o indicador foi movido: desde seu último uso ou se ele nunca foi usado desde sua criação.
Notas para chamadores
CreateBookmark aloca memória para o indicador que ele cria. Libere os recursos para o indicador chamando o método IMAPITable::FreeBookmark .