IMSLogon::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 , содержащую сведения о версии, компоненте и контексте для ошибки. Параметру lppMAPIError может быть присвоено значение NULL, если нет возвращаемого значения MAPIERROR.
Возвращаемое значение
S_OK
����� ������� � ������ ��������� ��������� ��� ��������.
MAPI_E_BAD_CHARWIDTH
Либо был установлен флаг MAPI_UNICODE и реализация не поддерживает Юникод, либо MAPI_UNICODE не задан и реализация поддерживает только Юникод.
Замечания
Используйте метод IMSLogon::GetLastError , чтобы получить сведения для отображения в сообщении пользователю относительно последней ошибки, возвращенной из вызова метода для объекта хранилища сообщений.
Чтобы освободить всю память, выделенную MAPI для возвращаемой структуры MAPIERROR , клиентские приложения должны вызывать только функцию MAPIFreeBuffer .
Возвращаемое значение getLastError должно быть S_OK, чтобы приложение использовало MAPIERROR. Даже если возвращаемое значение равно S_OK, mapIERROR может не возвращаться. Если реализация не может определить, какая была последняя ошибка, или если mapIERROR недоступен для этой ошибки, GetLastError возвращает указатель на NULL в lppMAPIError .