IPropData::HrSetPropAccess
Область применения: Outlook 2013 | Outlook 2016
Задает уровень доступа или состояние для одного или нескольких свойств объекта.
HRESULT HrSetPropAccess(
LPSPropTagArray lpPropTagArray,
ULONG FAR * rgulAccess
);
Параметры
lpPropTagArray
[в] Указатель на массив тегов свойств, указывающих на изменяемые свойства.
rgulAccess
[в] Массив битовых массивов флагов. Каждая битовая маска указывает уровни доступа или состояние (или и то, и другое) для каждого из свойств, определенных в массиве, на которые указывает параметр 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 изменяет уровень доступа и состояние свойств, определяемых тегами свойств в структуре SPropTagArray , на которую указывает параметр lpPropTagArray . Для каждого свойства есть соответствующая запись в массиве rgulAccess . Для записи можно задать один флаг, указывающий уровень доступа свойства, и другой флаг, указывающий его состояние.
Примечания для вызывающих методов
Используйте HrSetPropAccess , чтобы определить, когда изменяется определенное значение свойства, и изменить уровень доступа для одного или нескольких свойств объекта.