IMessage::GetAttachmentTable
Область применения: Outlook 2013 | Outlook 2016
Возвращает таблицу вложений сообщения.
HRESULT GetAttachmentTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
Параметры
ulFlags
[в] Битовая маска флагов, связанных с созданием таблицы. Можно задать следующий флаг:
MAPI_UNICODE
Строковые столбцы имеют формат Юникода. Если флаг MAPI_UNICODE не задан, строковые столбцы имеют формат ANSI.
MAPI_DEFERRED_ERRORS
Позволяет GetAttachmentTable успешно возвращать данные, возможно, до того, как таблица будет полностью доступна для вызывающего клиента. Если таблица недоступна, последующий вызов может вызвать ошибку.
lppTable
[out] Указатель на указатель на таблицу вложений.
Возвращаемое значение
S_OK
Таблица вложений успешно получена.
Замечания
Метод IMessage::GetAttachmentTable возвращает указатель на таблицу вложений сообщения, которая содержит сведения обо всех вложениях в сообщении. Клиенты могут получить доступ к вложению только через таблицу вложений. Извлекая номер вложения его свойство PR_ATTACH_NUM (PidTagAttachNumber), клиент может использовать несколько методов IMessage для работы с вложением.
Для каждого вложения имеется одна строка. Полный список столбцов в таблице вложений см. в разделе Таблицы вложений.
Вложение обычно не отображается в таблице вложений до тех пор, пока вложение и сообщение не будут сохранены с вызовом IMAPIProp::SaveChanges. Таблицы вложений являются динамическими. Если клиент создает новое вложение, удаляет существующее вложение или изменяет одно или несколько свойств после выполнения вызовов SaveChanges для вложения в сообщении, таблица вложений будет обновлена, чтобы отразить новые сведения.
Некоторые таблицы вложений поддерживают широкий спектр ограничений. другие нет. Поддержка ограничений зависит от реализации поставщика хранилища сообщений.
При первоначальном открытии таблицы вложений не обязательно отсортированы в определенном порядке.
Установка флага MAPI_UNICODE в параметре ulFlags влияет на следующие вызовы таблицы вложений:
IMAPITable::QueryColumns для получения набора столбцов.
IMAPITable::QueryRows для получения строк.
IMAPITable::QuerySortOrder для получения порядка сортировки.
При установке флага Юникода требуется, чтобы сведения для всех строковых столбцов, возвращаемых этими вызовами, были в формате Юникода. Однако, поскольку не все поставщики хранилища сообщений поддерживают Юникод, установка этого флага — это только запрос.