IMAPISupport::ModifyStatusRow
适用于:Outlook 2013 | Outlook 2016
通过添加新行或修改现有行来修改状态表。
HRESULT ModifyStatusRow(
ULONG cValues,
LPSPropValue lpColumnVals,
ULONG ulFlags
);
参数
cValues
[in]要包含在新状态表行或修改的状态表行中的属性计数。
lpColumnVals
[in]指向属性值数组的指针,这些属性值描述要作为新状态表行或已修改状态表行中的列包含的属性。
ulFlags
[in]标志的位掩码,控制定义状态表行的信息的处理方式。 可以设置以下标志:
STATUSROW_UPDATE
指示 MAPI 将 lpColumnVals 指向的数组中包含的属性与现有状态表行(而不是新行)合并。
返回值
S_OK
状态表已成功更新。
备注
为所有服务提供程序支持对象实现 IMAPISupport::ModifyStatusRow 方法。 服务提供商在登录时调用 ModifyStatusRow 以将行添加到状态表,并在会话期间的其他时间调用以更新行。 ModifyStatusRow 为 MAPI 提供生成状态表所需的信息。
给调用方的说明
调用 ModifyStatusRow 以更改现有状态表行中的属性时,设置STATUSROW_UPDATE标志。 这样做会通知 MAPI 在 lpColumnVals 参数中仅传递要更改的列。
客户端可以使用状态表中的信息来访问状态对象。
有关应在状态表行中包含的列的完整列表,请参阅 状态表。