IPropData::HrSetPropAccess

适用于:Outlook 2013 | Outlook 2016

设置对象的一个或多个属性的访问级别或状态。

HRESULT HrSetPropAccess(
  LPSPropTagArray lpPropTagArray,
  ULONG FAR * rgulAccess
);

参数

lpPropTagArray

[in]指向属性标记数组的指针,这些标记指示要修改的属性。

rgulAccess

[in]标志位掩码的数组。 每个位掩码指示 lpPropTagArray 参数指向的数组中标识的每个属性的访问级别或状态或两者。 这两个数组是位置的, rgulAccess 中的第一个位掩码描述 lpPropTagArray 指向的第一个属性,依序排列。 对于每个属性标记,可以设置一个访问级别标志和一个状态标志。 下表显示了可能的标志。

访问级别标志 状态标志
IPROP_READONLY,指示无法修改属性
IPROP_CLEAN,指示属性尚未修改。
IPROP_READWRITE,指示可以修改属性。 IPROP_DIRTY,指示属性已修改。

返回值

S_OK

已成功设置访问级别标志和状态标志。

MAPI_E_NO_ACCESS

尝试对只读对象或调用方权限不足的对象设置属性。

MAPI_E_INVALID_PARAMETER

rgulAccess 参数包含标志的无效组合,例如IPROP_READONLY和IPROP_READWRITE。

备注

IPropData::HrSetPropAccess 方法更改由 lpPropTagArray 参数指向的 SPropTagArray 结构中的属性标记标识的属性的访问级别和状态。 对于每个属性, rgulAccess 数组中都有相应的条目。 条目可以设置为一个指示属性访问级别的标志,另一个标志指示其状态。

给调用方的说明

使用 HrSetPropAccess 确定特定属性值何时更改,并更改对象的一个或多个属性的访问级别。

另请参阅

SPropTagArray

IPropData : IMAPIProp