MAPIERROR
適用於：Outlook 2013 |Outlook 2016
提供錯誤的詳細資訊，通常是由操作系統、MAPI 或服務提供者所產生。
| 屬性 | 值 |
|---|---|
| 標頭檔： |
Mapidefs.h |
typedef struct _MAPIERROR
{
ULONG ulVersion;
LPSTR lpszError;
LPSTR lpszComponent;
ULONG ulLowLevelError;
ULONG ulContext;
} MAPIERROR, FAR * LPMAPIERROR;
成員
ulVersion
結構的版本號碼。 ulVersion 成員用於未來的擴充，而且應該設定為 MAPI_ERROR_VERSION，目前定義為零。
lpszError
描述錯誤之字串的指標。 如果使用這個結構之方法的 ulFlags 參數設定為 MAPI_UNICODE，則此字串會是 Unicode 格式。
lpszComponent
字串的指標，描述產生錯誤的元件。 如果使用這個結構之方法的 ulFlags 參數設定為 MAPI_UNICODE，則此字串會是 Unicode 格式。
ulLowLevelError
只有當要傳回的錯誤為低層級時，才會使用的低層級錯誤值。
ulContext
值，表示識別錯誤發生位置之 lpszComponent 成員所指向元件中的位置。
註解
MAPIERROR 結構可用來描述錯誤資訊。 用戶端和服務提供者會在 IMAPIProp：：GetLastError 方法的 lppMAPIError 參數中傳遞 MAPIERROR 結構的指標。 GetLastError 會 傳回物件先前發生之錯誤的相關信息。 GetLastError 的呼叫端會呼叫 MAPIFreeBuffer，以釋放 MAPIERROR 結構的記憶體。
lpszComponent 成員可以用來對應元件的說明檔，如果有的話。 服務提供者應該將元件字串的大小限制為30個字元，以便輕鬆地顯示在對話框中。 ulContext 成員也可以用來參考在線幫助主題，以瞭解常見錯誤。
因為服務提供者不需要提供詳細的錯誤資訊，所以用戶端不應該預期傳回的任何 MAPIERROR 結構成員包含有效數據。 不過，至少MAPI強烈建議提供者指定 lpszComponent 和 ulContext 成員中的資訊。
如需MAPI中錯誤處理的詳細資訊，請參閱 錯誤處理。