Platform SDK: MAPI

ITableData::HrDeleteRow

The ITableData::HrDeleteRow method deletes a table row.

Quick Info

See ITableData : IUnknown.

HRESULT HrDeleteRow(
  LPSPropValue lpSPropValue  
);
 

Parameters

lpSPropValue
[in] Pointer to a property value structure describing the index column for the row to be deleted. The ulPropTag member of the property value structure should contain the same property tag as the ulPropTagIndexColumn parameter from the call to CreateTable.

Return Values

S_OK
The row was successfully deleted.
MAPI_E_NOT_FOUND
The property pointed to by the lpSPropValue parameter does not identify a row in the table.

Remarks

The ITableData::HrDeleteRow method removes the table row containing the column that matches the property pointed to by the lpSPropValue parameter. The data for the row is deleted and the row is removed from all open views.

After the row is deleted, notifications are sent to all clients or service providers with a view of the table that have called the table's IMAPITable::Advise method to register for notifications.

Deleting a row does not reduce the column set available to existing views or subsequently opened views, even if the deleted row was the last row with a value for a specific column.

See Also

CreateTable, ITableData::HrDeleteRows, ITableData::HrModifyRow, SPropValue, TABLE_NOTIFICATION