IMAPISupport::ModifyStatusRow
Gilt für: Outlook 2013 | Outlook 2016
Ändert die status Tabelle, indem eine neue Zeile hinzugefügt oder eine vorhandene Zeile geändert wird.
HRESULT ModifyStatusRow(
ULONG cValues,
LPSPropValue lpColumnVals,
ULONG ulFlags
);
Parameter
cValues
[in] Die Anzahl der Eigenschaften, die in die neue oder geänderte status Tabellenzeile eingeschlossen werden sollen.
lpColumnVals
[in] Ein Zeiger auf ein Array von Eigenschaftswerten, die die Eigenschaften beschreiben, die als Spalten in die neue oder geänderte status Tabellenzeile eingeschlossen werden sollen.
ulFlags
[in] Eine Bitmaske von Flags, die steuert, wie Informationen verarbeitet werden, die die status Tabellenzeile definieren. Das folgende Flag kann festgelegt werden:
STATUSROW_UPDATE
Weist MAPI an, die eigenschaften, die im Array enthalten sind, auf das lpColumnVals verweist, mit einer vorhandenen status Tabellenzeile anstatt in einer neuen Zeile zusammenzuführen.
Rückgabewert
S_OK
Die status Tabelle wurde erfolgreich aktualisiert.
Hinweise
Die IMAPISupport::ModifyStatusRow-Methode wird für alle Dienstanbieterunterstützungsobjekte implementiert. Dienstanbieter rufen ModifyStatusRow zum Anmeldezeitpunkt auf, um eine Zeile zur status Tabelle und zu anderen Zeiten während der Sitzung hinzuzufügen, um die Zeile zu aktualisieren. ModifyStatusRow stellt MAPI die informationen bereit, die zum Erstellen der status Tabelle erforderlich sind.
Hinweise für Aufrufer
Legen Sie das STATUSROW_UPDATE-Flag fest, wenn Sie ModifyStatusRow aufrufen, um Änderungen an den Eigenschaften in Der vorhandenen status Tabellenzeile vorzunehmen. Dadurch wird MAPI informiert, dass nur die zu ändernden Spalten im lpColumnVals-Parameter übergeben werden.
Clients können die Informationen in der status Tabelle verwenden, um auf Ihr status-Objekt zuzugreifen.
Eine vollständige Liste der Spalten, die Sie in Ihre status Tabellenzeile einschließen sollten, finden Sie unter Statustabellen.