ITableData::HrInsertRow
Hace referencia a: Outlook 2013 | Outlook 2016
Inserta una fila de tabla.
HRESULT HrInsertRow(
ULONG uliRow,
LPSRow lpSRow
);
Parameters
uliRow
[in] Número de fila secuencial que representa una fila específica. La nueva fila se colocará después de la fila que indica el número. El parámetro uliRow puede contener números de fila de 0 a n, donde n es el número total de filas de la tabla. Al pasar n en uliRow , se anexa la fila al final de la tabla.
lpSRow
[in] Puntero a una estructura SRow que describe la fila que se va a insertar.
Valor devuelto
S_OK
La fila se insertó correctamente.
MAPI_E_INVALID_PARAMETER
Ya existe en la tabla una fila que tiene el mismo valor para su columna de índice que la fila que se va a insertar.
Comentarios
El método ITableData::HrInsertRow inserta una fila en una tabla en una posición determinada. La nueva fila se inserta después de la fila que se encuentra en la posición especificada por el parámetro uliRow .
Si uliRow se establece en el número de filas de la tabla, la nueva fila se anexa al final de la tabla.
La propiedad que actúa como columna de índice de la tabla debe incluirse en el miembro lpProps de la estructura SRow a la que apunta el parámetro lpSRow . Esta propiedad de índice, normalmente PR_INSTANCE_KEY (PidTagInstanceKey), se usa para identificar de forma única la fila para futuras tareas de mantenimiento.
Las columnas de propiedad de la estructura SRow no tienen que estar en el mismo orden que las columnas de propiedad de la tabla.
Una vez insertada 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. No se envía ninguna notificación si la fila insertada no está incluida en la vista debido a una restricción.