HrGetOneProp
Область применения: Outlook 2013 | Outlook 2016
Извлекает значение одного свойства из интерфейса свойств, то есть интерфейса, производного от IMAPIProp.
| Свойство | Значение |
|---|---|
| Файл заголовка: |
Mapiutil.h |
| Реализовано в: |
MAPI |
| Вызывающая сторона: |
Клиентские приложения и поставщики услуг |
HRESULT HrGetOneProp(
LPMAPIPROP pmp,
ULONG ulPropTag,
LPSPropValue FAR * ppprop
);
Параметры
Pmp
[в] Указатель на интерфейс IMAPIProp , из которого извлекается значение свойства.
ulPropTag
[в] Тег свойства извлекаемого свойства.
ppprop
[out] Указатель на указатель на возвращаемую структуру SPropValue , определяющую полученное значение свойства.
Возвращаемое значение
MAPI_E_NOT_FOUND
Запрошенное свойство недоступно в указанном интерфейсе.
Замечания
В отличие от метода IMAPIProp::GetProps функция HrGetOneProp никогда не возвращает предупреждение. Так как он получает только одно свойство, он просто либо успешно, либо завершается сбоем. Для получения нескольких свойств GetProps работает быстрее.
Можно задать или изменить одно свойство с помощью функции HrSetOneProp .
Справочные материалы по MFCMAPI
Пример кода MFCMAPI указан в приведенной ниже таблице.
| Файл | Функция | Comment |
|---|---|---|
| MAPIFunctions.cpp |
GetMAPIObjectType |
MFCMAPI использует метод HrGetOneProp для получения типа объекта. |