IPropData::HrGetPropAccess
Область применения: Outlook 2013 | Outlook 2016
Извлекает уровень доступа и состояние для одного или нескольких свойств объекта.
HRESULT HrGetPropAccess(
LPSPropTagArray FAR * lppPropTagArray,
ULONG FAR * FAR * lprgulAccess
);
Параметры
lppPropTagArray
[вход, выход] Во входных данных — массив тегов свойств, указывающих свойства, для которых требуется получить уровни доступа и состояние; в противном случае — указатель на NULL, который указывает, что HrGetPropAccess должен получать уровни доступа и состояние для всех свойств. В выходных данных — массив тегов свойств, для которых были получены флаги доступа и состояния. Флаги хранятся в массиве, на который указывает параметр lprgulAccess .
lprgulAccess
[out] Указатель на массив битовых массивов флагов. Каждая битовая маска указывает уровни доступа или состояние или оба значения для каждого из свойств, определенных в массиве, на который указывает параметр lpPropTagArray . Два массива являются позициональными в том, что первая битовая маска, на которую указывает lprgulAccess , описывает первое свойство, на которое указывает lpPropTagArray , и т. д. Для каждого тега свойства можно задать следующие флаги:
| Флаг уровня доступа | Флаг состояния |
|---|---|
| IPROP_READONLY, указывающее, что свойство нельзя изменить. | IPROP_CLEAN, указывающее, что свойство не было изменено. |
| IPROP_READWRITE, указывающее, что свойство можно изменить. | IPROP_DIRTY, указывающее, что свойство было изменено. |
Возвращаемое значение
S_OK
Успешно возвращены флаги уровня доступа и состояния для свойств.
Замечания
Метод IPropData::HrGetPropAccess извлекает набор флагов, указывающих уровень доступа и состояние для одного или нескольких свойств.
Примечания для вызывающих.
HrGetPropAccess можно использовать для следующих целей:
Чтобы определить, изменил ли клиент или удалил записываемое свойство.
Чтобы предотвратить изменение или удаление свойства клиентом с помощью методов IMAPIProp .
Если одно из свойств в массиве тегов свойств, на которое указывает lppPropTagArray , удалено, HrGetPropAccess устанавливает для записи массива значение 0 в выходных данных. Если для lppPropTagArray задано значение NULL и одно из свойств объекта было удалено, то удаленное свойство возвращается в массиве.
Если свойство было изменено, его флаг IPROP_DIRTY устанавливается в соответствующей записи в массиве, на который указывает lprgulAccess . Ни IPROP_READONLY, ни IPROP_READWRITE не будут заданы.
Если свойство не было изменено или удалено, будет установлен только флаг IPROP_READONLY или IPROP_READWRITE.