IMAPISupport::Address

Статья
04/04/2023

Область применения: Outlook 2013 | Outlook 2016

Отображает диалоговое окно "Общий адрес".

HRESULT Address(
  ULONG_PTR FAR * lpulUIParam,
  LPADRPARM lpAdrParms,
  LPADRLIST FAR * lppAdrList
);

Параметры

lpulUIParam

[вход, выход] Указатель на дескриптор родительского окна диалогового окна. Во входных данных всегда должен передаваться дескриптор окна. В выходных данных, если флаг DIALOG_SDI задан в структуре ADRPARM , на которую указывает параметр lpAdrParms , возвращается дескриптор окна безрежимного диалогового окна.

lpAdrParms

[вход, выход] Указатель на структуру ADRPARM , которая управляет представлением и поведением диалогового окна адреса.

lppAdrList

[вход, выход] Указатель на указатель на список адресов. Во входных данных этот список является текущим списком получателей в сообщении или null, если такой список не существует. В выходных данных lppAdrList указывает на обновленный список получателей сообщений.

Возвращаемое значение

S_OK

Диалоговое окно "Адрес" было успешно отображено.

Замечания

Для объектов поддержки поставщика адресных книг реализован метод IMAPISupport::Address . Поставщики адресных книг вызывают Адрес , чтобы создать или обновить список получателей сообщений.

Каждый получатель описывается в структуре ADRENTRY , включенной в структуру ADRLIST , на которую указывает параметр lppAdrList . Структура ADRENTRY содержит массив значений свойств получателя, одно из которых является типом получателя или свойством PR_RECIPIENT_TYPE (PidTagRecipientType). Эту структуру ADRLIST можно передать клиенту для использования в качестве параметра lpMods при вызове IMessage::ModifyRecipients.

Каждый получатель в структуре ADRLIST может быть разрешен, что указывает, что одно из его значений свойства является свойством PR_ENTRYID (PidTagEntryId) или неразрешенным, что указывает на отсутствие свойства PR_ENTRYID .

В дополнение к PR_ENTRYID разрешенные получатели включают следующие свойства:

PR_RECIPIENT_TYPE
PR_DISPLAY_NAME (PidTagDisplayName)
PR_ADDRTYPE (PidTagAddressType)
PR_DISPLAY_TYPE (PidTagDisplayType)

Неразрешенные получатели обычно включают только PR_DISPLAY_NAME и PR_RECIPIENT_TYPE.

Примечания для вызывающих методов

Структура ADRLIST , которую передает вызывающий объект, может отличаться от размера структуры, возвращаемой MAPI. При выделении памяти для структуры ADRLIST выделите память для каждой структуры SPropValue отдельно.

Используйте указатели на функции выделения памяти MAPI, передаваемые в функцию ABProviderInit , чтобы выделить память. Выделите память с помощью функции MAPIAllocateBuffer для ADRLIST и каждой структуры значений свойства в структурах ADRENTRY в ADRLIST.

Если адрес должен возвращать большую структуру ADRLIST или если для lppAdrList передано значение NULL, адрес освобождает исходную структуру и выделяет новую. Адрес также выделяет дополнительные структуры значений свойств в структуре ADRLIST и освобождает старые структуры соответствующим образом. Дополнительные сведения об управлении памятью для структур ADRLIST см. в разделе Управление памятью для ADRLIST и структур SRowSet.

Адрес возвращает немедленно, если флаг DIALOG_SDI был задан в структуре ADRPARM в параметре lpAdrParms .

См. также

ABProviderInit
ADRENTRY
ADRLIST
ADRPARM
FreePadrlist
FreeProws
IMAPISupport::GetMemAllocRoutines
IMAPITable::QueryRows
IMessage::ModifyRecipients
MAPIAllocateBuffer
MAPIAllocateMore
MAPIFreeBuffer
Каноническое свойство PidTagAddressType
Каноническое свойство PidTagDisplayName
Каноническое свойство PidTagDisplayType
Каноническое свойство PidTagEntryId
Каноническое свойство PidTagRecipientType
SPropValue
SRowSet
Поддержка IMAPISupport: IUnknown управление памятью для структур ADRLIST и SRowSet

Поделиться через