MAPIERROR
Область применения: Outlook 2013 | Outlook 2016
Содержит подробные сведения об ошибке, обычно создаваемой операционной системой, MAPI или поставщиком услуг.
| Свойство | Значение |
|---|---|
| Файл заголовка: |
Mapidefs.h |
typedef struct _MAPIERROR
{
ULONG ulVersion;
LPSTR lpszError;
LPSTR lpszComponent;
ULONG ulLowLevelError;
ULONG ulContext;
} MAPIERROR, FAR * LPMAPIERROR;
Members
ulVersion
Номер версии структуры. Элемент ulVersion используется для дальнейшего расширения и должен иметь значение MAPI_ERROR_VERSION, которое в настоящее время определяется как ноль.
lpszError
Указатель на строку, описывающую ошибку. Эта строка будет иметь формат Юникода, если параметр ulFlags метода, в котором используется эта структура, имеет значение MAPI_UNICODE.
lpszComponent
Указатель на строку, описывающую компонент, создающий ошибку. Эта строка будет иметь формат Юникода, если параметр ulFlags метода, в котором используется эта структура, имеет значение MAPI_UNICODE.
ulLowLevelError
Низкоуровневое значение ошибки, которое используется только в том случае, если возвращаемая ошибка имеет низкий уровень.
ulContext
Значение, представляющее расположение в компоненте, на который указывает элемент lpszComponent , который определяет место возникновения ошибки.
Замечания
Структура MAPIERROR используется для описания сведений об ошибке. Клиенты и поставщики услуг передают указатель на структуру MAPIERROR в параметре lppMAPIError метода IMAPIProp::GetLastError . GetLastError возвращает сведения о предыдущей ошибке, которая произошла с объектом . Вызывающие методы GetLastError освобождают память для структуры MAPIERROR , вызывая MAPIFreeBuffer.
Элемент lpszComponent можно использовать для сопоставления файла справки компонента, если он существует. Поставщики услуг должны ограничить размер строки компонента до 30 символов, чтобы ее можно было легко отобразить в диалоговом окне. Элемент ulContext также можно использовать для ссылки на раздел справки в интернете для получения распространенных ошибок.
Так как поставщики услуг не обязаны предоставлять подробные сведения об ошибках, клиенты не должны ожидать, что какие-либо элементы структуры MAPIERROR , возвращаемые, будут содержать допустимые данные. Однако как минимум MAPI настоятельно рекомендует поставщикам указывать сведения в членах lpszComponent и ulContext .
Дополнительные сведения об обработке ошибок в MAPI см. в разделе Обработка ошибок.