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