IMAPITable::SeekRowApprox
Hace referencia a: Outlook 2013 | Outlook 2016
Mueve el cursor a una posición fraccionaria aproximada de la tabla.
HRESULT SeekRowApprox(
ULONG ulNumerator,
ULONG ulDenominator
);
Parameters
ulNumerator
[in] Puntero al numerador de la fracción que representa la posición de la tabla. Si el parámetro ulNumerator es cero, el cursor se coloca al principio de la tabla independientemente del valor del denominador. Si ulNumerator es igual al parámetro ulDenominator , el cursor se coloca después de la última fila de tabla.
ulDenominator
[in] Puntero al denominador de la fracción que representa la posición de la tabla. El parámetro ulDenominator no puede ser cero.
Valor devuelto
S_OK
La operación de búsqueda se realizó correctamente.
MAPI_E_BUSY
Hay otra operación en curso que impide que se inicie la operación de búsqueda de filas. Se debe permitir que se complete la operación en curso o se debe detener.
Comentarios
La posición del cursor en una tabla después de una llamada al método IMAPITable::SeekRowApprox es heurísticamente la fracción y podría no ser exacta. Por ejemplo, algunos proveedores pueden implementar una tabla encima de un árbol binario, tratando el punto medio de la tabla como la parte superior del árbol por motivos de rendimiento. Si el árbol no está equilibrado, es posible que el punto medio utilizado no esté exactamente a la mitad de la tabla.
Notas para los llamadores
Llame a SeekRowApprox para proporcionar los datos de una implementación de barra de desplazamiento. Por ejemplo, si el usuario coloca el cuadro de desplazamiento 2/3 hacia abajo en la barra de desplazamiento, puede modelar esa acción llamando a SeekRowApprox y pasando un valor fraccionario equivalente mediante ulNumerator y ulDenominator. La búsqueda SeekRowApprox siempre es absoluta desde el principio de la tabla. Para pasar al final de la tabla, los valores de ulNumerator y ulDenominator deben ser los mismos.
Use el esquema numérico adecuado. Es decir, para buscar una posición a mitad de la tabla, puede especificar 1/2, 10/20 o 50/100.