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_ADDRTYPE � PR_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 ������������ ��� ���������� ����� ����������� �� ���������. |