共用方式為


IMAPIProp::GetLastError

適用於:Outlook 2013 |Outlook 2016

傳回 MAPIERROR 結構,其中包含先前錯誤的相關信息。

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

參數

hResult

[in]前一個方法呼叫中所產生之錯誤碼的句柄。

ulFlags

[in]旗標的位掩碼,表示 lppMAPIError 所指向之 MAPIERROR 結構中所傳回文字的格式。 您可以設定下列旗標:

MAPI_UNICODE

字串應為 Unicode 格式。 如果未設定MAPI_UNICODE旗標,則字串應為 ANSI 格式。

lppMAPIError

[out] MAPIERROR 結構指標的指標,其中包含錯誤的版本、元件和內容資訊。 如果沒有要傳回的錯誤資訊, 可以將 lppMAPIError 參數設定為 NULL。

傳回值

S_OK

傳回錯誤資訊。

MAPI_E_BAD_CHARWIDTH

已設定MAPI_UNICODE旗標,且實作不支援 Unicode,或未設定MAPI_UNICODE,且實作僅支援 Unicode。

註解

IMAPIProp::GetLastError 方法會提供先前方法呼叫失敗的相關信息。 用戶端可以在對話框中包含 MAPIERROR 結構中的數據,為其使用者提供錯誤的詳細資訊。

MAPI 所提供 GetLastError 的所有實作都是 ANSI 實作,但 IAddrBook 實作 除外。 IAddrBook 隨附的 GetLastError 方法支援 Unicode。

實作者注意事項

遠端傳輸提供者實作這個方法的詳細數據,以及這個方法傳回的訊息,取決於傳輸提供者,因為對於不同的傳輸提供者,會導致各種 HRESULT 值的特定錯誤狀況會不同。

呼叫者注意事項

如果 GetLastError 提供 MAPIERROR 結構,只有在傳回值S_OK時,才能使用 lppMAPIError 參數所指向的 MAPIERROR 結構。 有時 GetLastError 無法判斷最後一個錯誤是什麼,或沒有關於錯誤的更多報告。 在此情況下,會改為在 lppMAPIError 中傳回 NULL 的指標。

若要釋放 MAPIERROR 結構的記憶體,請呼叫 MAPIFreeBuffer 函式。

如需 GetLastError 方法的詳細 資訊,請參閱 MAPI 擴充錯誤

另請參閱

IAddrBook:IMAPIProp

MAPIERROR

MAPIFreeBuffer

IMAPIProp:IUnknown

MAPI 擴充錯誤