ITableData::HrDeleteRows
Hace referencia a: Outlook 2013 | Outlook 2016
Elimina varias filas de tabla.
HRESULT HrDeleteRows(
ULONG ulFlags,
LPSRowSet lprowsetToDelete,
ULONG FAR * cRowsDeleted
);
Parameters
ulFlags
[in] Máscara de bits de marcas que controla la eliminación. Se puede establecer la marca siguiente:
TAD_ALL_ROWS
Elimina todas las filas de la tabla y todas las vistas correspondientes, enviando una única notificación TABLE_RELOAD.
lprowsetToDelete
[in] Puntero a un conjunto de filas que describe las filas que se van a eliminar. El parámetro lprowsetToDelete puede ser NULL si la marca de TAD_ALL_ROWS se establece en el parámetro ulFlags .
cRowsDeleted
[out] Recuento de las filas eliminadas.
Valor devuelto
S_OK
Las filas de tabla se eliminaron correctamente.
Comentarios
El método ITableData::HrDeleteRows busca y quita las filas de tabla que contienen las columnas que coinciden con la propiedad a la que apunta el miembro lpProps de cada entrada aRow del conjunto de filas. Se usa una columna de índice para identificar cada fila; esta columna debe tener la misma etiqueta de propiedad que la etiqueta de propiedad pasada en el parámetro ulPropTagIndexColumn en la llamada a la función CreateTable .
El número de filas que se eliminaron realmente se devuelve en cRowsDeleted. No se devuelve ningún error si no se encontró una o varias filas.
Una vez eliminadas las filas, las notificaciones se envían a todos los clientes o proveedores de servicios que tienen una vista de la tabla y que han llamado al método IMAPITable::Advise de la tabla para registrarse en las notificaciones.
La eliminación de filas no reduce las columnas disponibles para las vistas de tabla existentes ni las vistas de tabla abiertas posteriormente, incluso si las filas eliminadas son las últimas que tienen valores para una columna específica.