IMAPITable::GetRowCount
Hace referencia a: Outlook 2013 | Outlook 2016
Devuelve el número total de filas de la tabla.
HRESULT GetRowCount(
ULONG ulFlags,
ULONG FAR * lpulCount
);
Parameters
ulFlags
Reservados; debe ser cero.
lpulCount
[out] Puntero al número de filas de la tabla.
Valor devuelto
S_OK
El recuento de filas se devolvió correctamente.
MAPI_E_BUSY
Hay otra operación en curso que impide que se inicie la operación de recuperación del recuento de filas. Se debe permitir que se complete la operación en curso o se debe detener.
MAPI_E_NO_SUPPORT
La tabla no puede calcular el número de filas.
MAPI_W_APPROX_COUNT
La llamada se realizó correctamente, pero se devolvió un recuento aproximado de filas porque no se pudo determinar el recuento exacto de filas posiblemente debido a restricciones de memoria. Para probar esta advertencia, use la macro HR_FAILED . Consulte Uso de macros para el control de errores.
Comentarios
El método IMAPITable::GetRowCount recupera el número total de filas de una tabla.
Notas a los implementadores
Si no puede determinar el recuento exacto de filas de la tabla, devuelva MAPI_W_APPROX_COUNT y un recuento aproximado de filas en el contenido del parámetro lpulCount .
Notas para los llamadores
Use GetRowCount para averiguar cuántas filas contiene una tabla antes de realizar una llamada al método IMAPITable::QueryRows para recuperar los datos. Si hay menos de veinte filas en la tabla, es seguro llamar a QueryPosition para recuperar toda la tabla. Si hay más de veinte filas en la tabla, considere la posibilidad de realizar varias llamadas a QueryPosition y limitar el número de filas recuperadas en cada llamada.
Algunas tablas no admiten GetRowCount y devuelven MAPI_E_NO_SUPPORT. Si no se admite GetRowCount , una alternativa podría ser llamar a IMAPITable::QueryPosition. Con los resultados de QueryPosition, puede determinar la relación entre la fila actual y la última fila.
Cuando GetRowCount devuelve MAPI_E_BUSY porque no puede recuperar temporalmente un recuento de filas, llame al método IMAPITable::WaitForCompletion . Cuando se devuelve WaitForCompletion , vuelva a intentar la llamada a GetRowCount. Otra manera de detectar si una operación asincrónica está en curso es llamar al método IMAPITable::GetStatus y comprobar el contenido del parámetro lpulTableState .
Referencia de MFCMAPI
Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.
| Archivo | Función | Comment |
|---|---|---|
| MAPIFunctions.cpp |
CopyFolderContents |
MFCMAPI usa el método IMAPITable::GetRowCount para determinar cuántas filas hay en la tabla de origen para que se pueda asignar memoria para realizar la copia. |