ITableData::HrDeleteRow
Gilt für: Outlook 2013 | Outlook 2016
Löscht eine Tabellenzeile.
HRESULT HrDeleteRow(
LPSPropValue lpSPropValue
);
Parameter
lpSPropValue
[in] Ein Zeiger auf eine Eigenschaftswertstruktur, die die Indexspalte für die zu löschende Zeile beschreibt. Das ulPropTag-Element der Eigenschaftswertstruktur sollte dasselbe Eigenschaftstag wie der ulPropTagIndexColumn-Parameter aus dem Aufruf der CreateTable-Funktion enthalten.
Rückgabewert
S_OK
Die Zeile wurde erfolgreich gelöscht.
MAPI_E_NOT_FOUND
Die Eigenschaft, auf die der lpSPropValue-Parameter verweist, identifiziert keine Zeile in der Tabelle.
Hinweise
Die ITableData::HrDeleteRow-Methode entfernt die Tabellenzeile, die die Spalte enthält, die der Eigenschaft entspricht, auf die der lpSPropValue-Parameter zeigt. Die Daten für die Zeile werden gelöscht, und die Zeile wird aus allen geöffneten Ansichten entfernt.
Nachdem die Zeile gelöscht wurde, werden Benachrichtigungen an alle Clients oder Dienstanbieter gesendet, die über eine Ansicht der Tabelle verfügen und die IMAPITable::Advise-Methode der Tabelle aufgerufen haben, um sich für Benachrichtigungen zu registrieren.
Durch das Löschen einer Zeile wird der Spaltensatz, der für vorhandene Ansichten oder anschließend geöffnete Sichten verfügbar ist, nicht reduziert, auch wenn die gelöschte Zeile die letzte Zeile ist, die einen Wert für eine bestimmte Spalte aufweist.