ITableData::HrModifyRows
Hace referencia a: Outlook 2013 | Outlook 2016
Inserta varias filas de tabla, posiblemente reemplazando las filas existentes.
HRESULT HrModifyRows(
ULONG ulFlags,
LPSRowSet lpSRowSet
);
Parameters
ulFlags
[entrada] Reservado; debe ser cero.
lpSRowSet
[in] Puntero a una estructura SRowSet que contiene el conjunto de filas que se van a agregar, reemplazando las filas existentes si es necesario. Una de las estructuras de valor de propiedad a las que apunta el miembro lpProps de cada estructura SRow del conjunto de filas debe contener la columna de índice, el mismo valor que se especificó en el parámetro ulPropTagIndexColumn en la llamada a la función CreateTable .
Valor devuelto
S_OK
Las filas se insertaron o modificaron correctamente.
MAPI_E_INVALID_PARAMETER
Una o varias de las filas pasadas no tienen una columna de índice. Si se devuelve este error, no se cambia ninguna fila.
Comentarios
El método ITableData::HrModifyRows inserta las filas descritas por la estructura SRowSet a la que apunta el parámetro lpSRowSet . Si el valor de columna de índice de una fila del conjunto de filas coincide con el valor de una fila existente de la tabla, se reemplaza la fila existente. Si no existe ninguna fila que coincida con la incluida en la estructura SRowSet , HrModifyRows agrega la fila al final de la tabla.
Todas las vistas de la tabla se modifican para incluir las filas a las que apunta lpSRowSet. Sin embargo, si una vista tiene una restricción que excluye una fila, es posible que no sea visible para el usuario.
Las columnas de las filas a las que apunta lpSRowSet no tienen que estar en el mismo orden que las columnas de la tabla. El autor de la llamada también puede incluir como propiedades de columnas que no están actualmente en la tabla. En el caso de las vistas existentes, HrModifyRows hace que estas nuevas columnas estén disponibles, pero no las incluya en el conjunto de columnas actual. Para vistas futuras, HrModifyRows incluye las nuevas columnas del conjunto de columnas.
Una vez que HrModifyRows ha agregado 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. MAPI envía notificaciones de TABLE_ROW_ADDED o TABLE_ROW_MODIFIED para cada fila, hasta ocho filas. Si la llamada HrModifyRows afecta a más de ocho filas, MAPI envía una única notificación TABLE_CHANGED en su lugar.