ITableData::HrModifyRow
Hace referencia a: Outlook 2013 | Outlook 2016
Inserta una nueva fila de tabla, posiblemente reemplazando una fila existente.
HRESULT HrModifyRow(
LPSRow lpSRow
);
Parameters
lpSRow
[in] Puntero a una estructura SRow que describe la fila que se va a agregar o para reemplazar una fila existente. Una de las estructuras de valor de propiedad a las que apunta el miembro lpProps de la estructura SRow 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
La fila se insertó o modificó correctamente.
MAPI_E_INVALID_PARAMETER
La fila pasada no tiene una columna de índice.
Comentarios
El método ITableData::HrModifyRow inserta la fila descrita por la estructura SRow a la que apunta el parámetro lpSRow . Si ya existe en la tabla una fila que tenga el mismo valor para su columna de índice que la fila a la que apunta lpSRow , se reemplaza la fila existente. Si no existe ninguna fila que coincida con la incluida en la estructura SRow , HrModifyRow agrega la fila al final de la tabla.
Todas las vistas de la tabla se modifican para incluir la fila a la que apunta lpSRow. Sin embargo, si una vista tiene una restricción que excluye la fila, es posible que no sea visible para el usuario.
Las columnas de la fila a las que apunta lpSRow 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, HrModifyRow hace que estas nuevas columnas estén disponibles, pero no las incluya en el conjunto de columnas actual. Para vistas futuras, HrModifyRow incluye las nuevas columnas del conjunto de columnas.
Una vez que HrModifyRow agrega la fila, 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.