IMAPISupport::GetLastError

Статья
04/04/2023

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

Возвращает структуру MAPIERROR , содержащую сведения о предыдущей ошибке объекта поддержки.

HRESULT GetLastError(
  HRESULT hResult,
  ULONG ulFlags,
  LPMAPIERROR FAR * lppMAPIError
);

Параметры

Hresult

[в] Дескриптор значения ошибки, созданного в предыдущем вызове метода для объекта поддержки.

ulFlags

[в] Битовая маска флагов, управляющая типом возвращаемых строк. Можно задать следующий флаг:

MAPI_UNICODE

Строки в структуре MAPIERROR , возвращенные в параметре lppMAPIError , имеют формат Юникода. Если флаг MAPI_UNICODE не задан, строки имеют формат ANSI.

lppMAPIError

[out] Указатель на указатель на структуру MAPIERROR , содержащую сведения о версии, компоненте и контексте для ошибки. Параметру lppMAPIError может быть присвоено значение NULL, если не удается предоставить структуру MAPIERROR с соответствующими сведениями об ошибке.

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

S_OK

Вызов выполнен успешно и возвращает ожидаемое значение или значения.

MAPI_E_BAD_CHARWIDTH

Флаг MAPI_UNICODE установлен, а MAPI не поддерживает Юникод, или MAPI_UNICODE не задан и MAPI поддерживает только Юникод.

Замечания

Метод IMAPISupport::GetLastError реализован для всех объектов поддержки. Вызывающие могут предоставить своим пользователям подробные сведения об ошибке, включив данные из структуры MAPIERROR в диалоговом окне.

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

Указатель на структуру MAPIERROR можно использовать, если MAPI предоставляет его, в параметре lppMAPIError только в том случае, если GetLastError возвращает S_OK. Иногда MAPI не может определить, какая была последняя ошибка, или ему больше нечего сообщить об этой ошибке. В этом случае lppMAPIError возвращает указатель на NULL.

Дополнительные сведения о методе GetLastError см. в разделе Расширенные ошибки MAPI.

Чтобы освободить всю память, выделенную MAPI, вызовите функцию MAPIFreeBuffer для возвращаемой структуры MAPIERROR .

См. также

MAPIERROR
MAPIFreeBuffer
IMAPISupport: расширенные ошибки MAPI IUnknown

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