ITableData::HrModifyRow
Gilt für: Outlook 2013 | Outlook 2016
Fügt eine neue Tabellenzeile ein und ersetzt möglicherweise eine vorhandene Zeile.
HRESULT HrModifyRow(
LPSRow lpSRow
);
Parameter
lpSRow
[in] Ein Zeiger auf eine SRow-Struktur , die die hinzuzufügende Zeile beschreibt oder eine vorhandene Zeile ersetzt. Eine der Eigenschaftenwertstrukturen, auf die das lpProps-Element der SRow-Struktur verweist, sollte die Indexspalte enthalten, den gleichen Wert, der im ulPropTagIndexColumn-Parameter im Aufruf der CreateTable-Funktion angegeben wurde.
Rückgabewert
S_OK
Die Zeile wurde erfolgreich eingefügt oder geändert.
MAPI_E_INVALID_PARAMETER
Die übergebene Zeile weist keine Indexspalte auf.
Hinweise
Die ITableData::HrModifyRow-Methode fügt die Zeile ein, die von der SRow-Struktur beschrieben wird, auf die der lpSRow-Parameter verweist. Wenn eine Zeile, die denselben Wert für ihre Indexspalte aufweist wie die Zeile, auf die lpSRow zeigt, bereits in der Tabelle vorhanden ist, wird die vorhandene Zeile ersetzt. Wenn keine Zeile vorhanden ist, die mit der in der SRow-Struktur enthaltenen übereinstimmt, fügt HrModifyRow die Zeile am Ende der Tabelle hinzu.
Alle Ansichten der Tabelle werden so geändert, dass sie die Zeile enthalten, auf die lpSRow zeigt. Wenn eine Ansicht jedoch eine Einschränkung aufweist, die die Zeile ausschließt, ist sie für den Benutzer möglicherweise nicht sichtbar.
Die Spalten in der Zeile, auf die lpSRow verweist, müssen nicht in der gleichen Reihenfolge wie die Spalten in der Tabelle sein. Der Aufrufer kann auch Als Spalteneigenschaften einschließen, die derzeit nicht in der Tabelle enthalten sind. Für vorhandene Sichten stellt HrModifyRow diese neuen Spalten zur Verfügung, schließt sie jedoch nicht in den aktuellen Spaltensatz ein. Für zukünftige Ansichten schließt HrModifyRow die neuen Spalten in den Spaltensatz ein.
Nachdem HrModifyRow die Zeile hinzugefügt hat, 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.