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 确定特定属性值何时更改,并更改对象的一个或多个属性的访问级别。