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


IMessage::ModifyRecipients

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

����������, �������� ��� �������� ����������� ���������.

HRESULT ModifyRecipients(
  ULONG ulFlags,
  LPADRLIST lpMods
);

Параметры

ulFlags

[in] ������� ����� �����, ������� ��������� ����������� ���������. Если для параметра ulFlags передается ноль, ModifyRecipients заменяет всех существующих получателей списком получателей, на который указывает параметр lpMods . Для ulFlags можно задать следующие флаги:

MODRECIP_ADD

Получатели, на которые указывает параметр lpMods , должны быть добавлены в список получателей.

MODRECIP_MODIFY

Получатели, на которые указывает параметр lpMods, должны заменить существующих получателей. ��� ������������ �������� ���������� �������� �������� ��������������� ��������� ADRENTRY .

MODRECIP_REMOVE

Существующие получатели должны быть удалены из списка получателей, используя в качестве индекса свойство PR_ROWID (PidTagRowid), включенное в массив значений свойств каждой записи получателя в параметре lpMods .

lpMods

[in] ��������� �� ��������� ADRLIST , ������� �������� ������ �����������, ����� ���� ���������, ������� ��� �������� � ���������.

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

S_OK

��������� ������ ����������� ��������� �������.

Замечания

����� IMessage::ModifyRecipients �������� ������ ����������� ���������. ��� �� ����� ������, ������� ���������� � ��������� ADRLIST , ��� ����������� ����������.

��������� ADRLIST �������� ���� ��������� ADRENTRY ��� ������� ����������, � ������ ADRENTRY ��������� �������� ������ �������� �������, ����������� ���������� ����������.

������ ����������� � ��������� ADRLIST ����� ��������� ��� ���������. ������� ����������� � ����� � ���� ��������, ������� ��������. Неразрешенный получатель содержит только свойства PR_DISPLAY_NAME (PidTagDisplayName) и PR_RECIPIENT_TYPE (PidTagRecipientType), а разрешенный получатель содержит эти два свойства плюс PR_ADDRTYPE (PidTagAddressType) и PR_ENTRYID (PidTagEntryId). Если доступно PR_EMAIL_ADDRESS (PidTagEmailAddress), его также можно включить.

����� �������� ��������� ��� ���������� �������� ������ ����������� ���������� ����������� � ��� ������ �����������. ���������� ����������� ������� ����� � ���������� ��� ������ � ��������� ��������� ����������� ���������. �������������� �������� � �������� ���������� ���� � ����� ������ ������� ������������� ������. ��� ��������� �������������� �������� � ����� ������ ������� � �������� ����� ������ ���������� ���������� ����.

� ���������� � ����������� ���������� � ���������� ����������� ���������� ����� ���� NULL. ���� cValues ��������� ADRENTRY ��� ���������� ������������� ������� �������� � ���� rgPropVals ����� �������� NULL.

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

����� ������� ������ �����������, ������ IAddrBook::Address ��� ����������� ����������� ���������� ����� � ���������� ������������ ������� ��������. Список адресов, на который указывает параметр lppAdrListдля address , можно передать в ModifyRecipients в качестве параметра lpMods .

��� �������� �������� ��� ���������� � ��������� ADRLIST �������� ��� �������� ����������, �� ������ �� ��� ����� ��� ����������. ��� ��������� ����������, ��������� ��� ��������, �� ���������� � ��������� ADRLIST. ��� ��������� �������� ������ ������� ��� ���� ����������� ���������, �������� GetRecipientTable � �������� ��� ������. ��������� � ��������� ��������� ADRLISTSRowSet, �� ����� ������������ �����������.

ModifyRecipients заменяет все записи в текущем списке получателей сведениями, на которые указывает lpMods , если ни один из флагов не задан в параметре ulFlags .

При установке флага MODRECIP_MODIFY ModifyRecipients заменяет каждую строку получателя связанной строкой в структуре ADRLIST , переданной в lpMods. ������� �� ��� ������� ��� ��������, ������� ������ ����� ���������� ���������� �� ����, �������� �� ��� ���� �������� ��� �������������� ���������� ��������.

���� ����������� ��������� ������� ��� ��������� ������� ����������� � ��������� ADRLIST.

  • �� ����������� PT_NULL � �������� ���� ��������. ModifyRecipients ���������� ������ ��� ����������� ��� ��������.

  • �� ����������� PT_ERROR � �������� ���� ��������. ModifyRecipients ���������� ��� ��������.

  • Добавьте свойство PR_ROWID для всех получателей при установке флага MODRECIP_REMOVE или MODRECIP_MODIFY в ulFlags.

  • Не включайте свойство PR_ROWID ни для одного из получателей при установке флага MODRECIP_ADD в ulFlags или при передаче нуля в ulFlags.

���� �������� �������� PR_ADDRTYPE ��� �������� PR_EMAIL_ADDRESS ��� ����������, � ������ ��� ��� ��� ��������, �� ������������� ��� ������ � ����� ����������, ��� ���������� � PR_ENTRYID, ���������� �� ����������. �� ���� ���������� ��� ��������, � ����������� �� ���������� �����.

  • ��������� ������������ �� �����, ������������ �������� PR_ADDRTYPEPR_EMAIL_ADDRESS.

  • ��������� ����� ���������� ����������, ������������ ��������� PR_ENTRYID.

  • ��������� ����� ��������� �������������� ��-�� ���������������� �������� �� ������.

������������� ������� �������������, ��������� � ������ ADRLIST � SRowSet �������� ��� ��������� ������ ��� ������ �����������. ModifyRecipients �� ����������� ��������� ADRLIST �� ����� -���� �� �� ��������� ���������. ��������� ADRLIST � ������� SPropValue ��������� ���������� �������� �������� � ������� ������� MAPIAllocateBuffer ����� �������, ����� ���������� ������� �� �����������. ���� ����� ������� ��������������� ����� �� ����� ��� ������ SPropValue ���������, ��� ����� �������� ��������� SPropValue ��� ����� ���������� ����� ������� ������ � ������� MAPIFreeBuffer. �������� ��������� SPropValue ����� ����� ���������� � ������� MAPIFreeBuffer.

Справочные материалы по MFCMAPI

Пример кода MFCMAPI указан в приведенной ниже таблице.

Файл Функция �����������
MAPIABFunctions.cpp
AddRecipient
Mfcmapi (en) ����� IMessage::ModifyRecipients ������������ ��� ���������� ����� ����������� �� ���������.

См. также

ADRENTRY

ADRLIST

IAddrBook::Address

IMAPISupport::Address

MAPIAllocateBuffer

MAPIFreeBuffer

SPropValue

IMessage: IMAPIProp

Mfcmapi (en) � �������� ������� ����