IPersistMessage::GetLastError
Область применения: Outlook 2013 | Outlook 2016
Возвращает структуру MAPIERROR , содержащую сведения о предыдущей ошибке в объекте формы.
HRESULT GetLastError(
HRESULT hResult,
ULONG ulFlags,
LPMAPIERROR FAR * lppMAPIError
);
Параметры
Hresult
[в] Тип данных HRESULT, содержащий значение ошибки, созданное при предыдущем вызове метода.
ulFlags
[в] Битовая маска флагов, управляющая типом возвращаемых строк. Можно задать следующий флаг:
MAPI_UNICODE
Строки в структуре MAPIERROR , возвращенные в параметре lppMAPIError , имеют формат Юникода. Если флаг MAPI_UNICODE не задан, строки имеют формат ANSI.
lppMAPIError
[out] Указатель на указатель на структуру MAPIERROR , содержащую сведения о версии, компоненте и контексте для ошибки. Если форма не может предоставить соответствующую информацию для структуры MAPIERROR, параметру lppMAPIError можно задать значение NULL.
Возвращаемое значение
S_OK
����� ������� � ������ ��������� ��������� ��� ��������.
MAPI_E_BAD_CHARWIDTH
Либо был установлен флаг MAPI_UNICODE, а поставщик адресной книги не поддерживает Юникод, либо MAPI_UNICODE не задан, а поставщик адресной книги поддерживает только Юникод.
Замечания
Объекты form реализуют метод IPersistMessage::GetLastError для предоставления сведений о предыдущем вызове метода, который завершился ошибкой. Средства просмотра форм могут предоставить пользователям подробные сведения об ошибке, включив в диалоговое окно данные из структуры MAPIERROR .
Вызов Метода GetLastError не влияет на состояние формы. При возврате метода GetLastError форма остается в том состоянии, в которое она находилась до выполнения вызова.
Примечания для вызывающих методов
Структуру MAPIERROR можно использовать, если форма предоставляет один, на который указывает параметр lppMAPIError , только если GetLastError возвращает S_OK. Иногда форма не может определить, какая была последняя ошибка, или не может сообщить о ней больше. В этом случае форма возвращает указатель на NULL в lppMAPIError .
Дополнительные сведения о методе GetLastError см. в разделе Расширенные ошибки MAPI.