ADRENTRY
Область применения: Outlook 2013 | Outlook 2016
Описывает ноль или несколько свойств, принадлежащих получателю.
| Значение | Описание |
|---|---|
| Файл заголовка: |
Mapidefs.h |
typedef struct _ADRENTRY
{
ULONG ulReserved1;
ULONG cValues;
LPSPropValue rgPropVals;
} ADRENTRY, FAR *LPADRENTRY;
Members
ulReserved1
Защищены; значение должно быть равно нулю.
cValues
Количество свойств в массиве значений свойств, на которые указывает элемент rgPropVals . Элемент cValues может быть равен нулю.
rgPropVals
Указатель на массив значений свойств, описывающий свойства получателя. Элемент rgPropVals может иметь значение NULL.
Замечания
Структура ADRENTRY описывает свойства, принадлежащие одному получателю. К свойствам, которые обычно используются для описания получателя, относятся следующие:
PR_DISPLAY_NAME (PidTagDisplayName)
PR_ADDRTYPE (PidTagAddressType)
PR_EMAIL_ADDRESS (PidTagEmailAddress)
PR_ENTRYID (PidTagEntryId)
Когда идентификатор записи или свойство PR_ENTRYID отображается в массиве SPropValue для получателя, это означает, что получатель был разрешен. Клиенты вызывают метод IAddrBook::ResolveName , чтобы убедиться, что все получатели в списке получателей исходящего сообщения были разрешены. С сообщениями могут отправляться только разрешенные получатели.
Структуры ADRENTRY обычно объединяются для формирования массива для члена aEntries структуры ADRLIST.
Структуры ADRENTRY и структуры SRow идентичны, так как они содержат зарезервированный член, массив значений свойств и количество значений в массиве. В то время как структуры ADRENTRY объединяются для формирования элемента aEntries структуры ADRLIST , структуры SRow объединяются для формирования члена aRow структуры SRowSet . Оба типа структур следуют одинаковым правилам распределения, подразумевая, что структура SRowSet , полученная из таблицы содержимого контейнера адресной книги, может быть приведена к структуре ADRLIST и использоваться как есть.
Структура ADRENTRY может быть пустой. Например, структура ADRENTRY , содержащаяся в структуре ADRLIST , на которую указывает параметр lppAdrList при вызове IAddrBook::Address , может быть пустой при удалении получателя.
Дополнительные сведения о выделении памяти для структур ADRENTRY см. в разделе Управление памятью для ADRLIST и структур SRowSet.
См. также
IAddrBook::Address
IMessage::ModifyRecipients
MAPIAllocateBuffer
ADRLIST
SRow
Структуры MAPI SRowSet