IMAPISupport::ModifyStatusRow
Applies to: Outlook 2013 | Outlook 2016
Modifies the status table by adding a new row or modifying an existing row.
HRESULT ModifyStatusRow(
ULONG cValues,
LPSPropValue lpColumnVals,
ULONG ulFlags
);
Parameters
cValues
[in] The count of properties to be included in the new or modified status table row.
lpColumnVals
[in] A pointer to an array of property values that describe the properties to be included as columns in the new or modified status table row.
ulFlags
[in] A bitmask of flags that controls how information that defines the status table row is processed. The following flag can be set:
STATUSROW_UPDATE
Directs MAPI to merge the properties included in the array pointed to by lpColumnVals with an existing status table row, rather than in a new row.
Return value
S_OK
The status table was successfully updated.
Remarks
The IMAPISupport::ModifyStatusRow method is implemented for all service provider support objects. Service providers call ModifyStatusRow at logon time to add a row to the status table and at other times during the session to update the row. ModifyStatusRow provides MAPI with the information necessary to build the status table.
Notes to callers
Set the STATUSROW_UPDATE flag when you call ModifyStatusRow to make changes to the properties in your existing status table row. Doing so informs MAPI that only the columns being changed are passed in the lpColumnVals parameter.
Clients can use the information in the status table to access your status object.
For a complete list of columns that you should include in your status table row, see Status Tables.