ITableData::HrInsertRow
Gilt für: Outlook 2013 | Outlook 2016
Fügt eine Tabellenzeile ein.
HRESULT HrInsertRow(
ULONG uliRow,
LPSRow lpSRow
);
Parameter
uliRow
[in] Eine sequenzielle Zeilennummer, die eine bestimmte Zeile darstellt. Die neue Zeile wird hinter der Zeile platziert, die die Zahl angibt. Der uliRow-Parameter kann Zeilennummern von 0 bis n enthalten, wobei n die Gesamtzahl der Zeilen in der Tabelle ist. Wenn n in uliRow übergeben wird, wird die Zeile an das Ende der Tabelle angefügt.
lpSRow
[in] Ein Zeiger auf eine SRow-Struktur , die die einzufügende Zeile beschreibt.
Rückgabewert
S_OK
Die Zeile wurde erfolgreich eingefügt.
MAPI_E_INVALID_PARAMETER
Eine Zeile, die denselben Wert für ihre Indexspalte wie die einzufügende Zeile aufweist, ist bereits in der Tabelle vorhanden.
Hinweise
Die ITableData::HrInsertRow-Methode fügt eine Zeile an einer bestimmten Position in eine Tabelle ein. Die neue Zeile wird nach der Zeile eingefügt, die sich an der durch den uliRow-Parameter angegebenen Position befindet.
Wenn uliRow auf die Anzahl der Zeilen in der Tabelle festgelegt ist, wird die neue Zeile am Ende der Tabelle angefügt.
Die Eigenschaft, die als Indexspalte für die Tabelle fungiert, muss im lpProps-Member der SRow-Struktur enthalten sein, auf die der lpSRow-Parameter verweist. Diese Indexeigenschaft, in der Regel PR_INSTANCE_KEY (PidTagInstanceKey), wird verwendet, um die Zeile für zukünftige Wartungsaufgaben eindeutig zu identifizieren.
Die Eigenschaftenspalten in der SRow-Struktur müssen nicht in der gleichen Reihenfolge wie die Eigenschaftenspalten in der Tabelle vorliegen.
Nachdem die Zeile eingefügt 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. Es wird keine Benachrichtigung gesendet, wenn die eingefügte Zeile aufgrund einer Einschränkung nicht in der Ansicht enthalten ist.