IMAPITable::SeekRowApprox
Aplica-se a: Outlook 2013 | Outlook 2016
Move o cursor para uma posição fracionária aproximada na tabela.
HRESULT SeekRowApprox(
ULONG ulNumerator,
ULONG ulDenominator
);
Parâmetros
ulNumerator
[in] Ponteiro para o numerador da fração que representa a posição da tabela. Se o parâmetro ulNumerator for zero, o cursor será posicionado no início da tabela, independentemente do valor do denominador. Se ulNumerator for igual ao parâmetro ulDenominator , o cursor será posicionado após a última linha da tabela.
ulDenominator
[in] Ponteiro para o denominador da fração que representa a posição da tabela. O parâmetro ulDenominator não pode ser zero.
Valor de retorno
S_OK
A operação de busca foi bem-sucedida.
MAPI_E_BUSY
Outra operação está em andamento que impede o início da operação de busca de linhas. A operação em andamento deve ser autorizada a ser concluída ou deve ser interrompida.
Comentários
A posição do cursor em uma tabela após uma chamada para o método IMAPITable::SeekRowApprox é heuristicamente a fração e pode não ser exata. Por exemplo, determinados provedores podem implementar uma tabela em cima de uma árvore binária, tratando o ponto de meio da tabela como a parte superior da árvore por razões de desempenho. Se a árvore não estiver balanceada, o meio do caminho usado pode não estar exatamente na metade da tabela.
Notas para chamadores
Chame SeekRowApprox para fornecer os dados para uma implementação da barra de rolagem. Por exemplo, se o usuário posicionar a caixa de rolagem 2/3 na barra de rolagem, você poderá modelar essa ação chamando SeekRowApprox e passando um valor fracionário equivalente usando ulNumerator e ulDenominator. A pesquisa SeekRowApprox é sempre absoluta desde o início da tabela. Para mover para o final da tabela, os valores em ulNumerator e ulDenominator devem ser os mesmos.
Use qualquer esquema de número apropriado. Ou seja, para buscar uma posição no meio da tabela, você pode especificar 2/1, 20/10 ou 50/100.