IMAPISupport::GetLastError
適用対象: Outlook 2013 | Outlook 2016
前のサポート オブジェクト エラーに関する情報を含む MAPIERROR 構造体を返します。
HRESULT GetLastError(
HRESULT hResult,
ULONG ulFlags,
LPMAPIERROR FAR * lppMAPIError
);
パラメーター
Hresult
[in]サポート オブジェクトの前のメソッド呼び出しで生成されたエラー値のハンドル。
ulFlags
[in]返される文字列の種類を制御するフラグのビットマスク。 次のフラグを設定できます。
MAPI_UNICODE
lppMAPIError パラメーターで返される MAPIERROR 構造体の文字列は Unicode 形式です。 MAPI_UNICODE フラグが設定されていない場合、文字列は ANSI 形式です。
lppMAPIError
[out]エラーのバージョン、コンポーネント、コンテキスト情報を含む MAPIERROR 構造体へのポインター。 適切なエラー情報を含む MAPIERROR 構造体を指定できない場合は、lppMAPIError パラメーターを NULL に設定できます。
戻り値
S_OK
呼び出しは成功し、期待される値または値を返しました。
MAPI_E_BAD_CHARWIDTH
MAPI_UNICODE フラグが設定され、MAPI で Unicode がサポートされていないか、MAPI_UNICODEが設定されておらず、MAPI で Unicode のみがサポートされています。
注釈
IMAPISupport::GetLastError メソッドは、すべてのサポート オブジェクトに対して実装されます。 呼び出し元は、ダイアログ ボックスに MAPIERROR 構造体のデータを含めることで、エラーに関する詳細情報をユーザーに提供できます。
呼び出し側への注意
MAPI 構造体へのポインターは、MAPI が提供する場合は、getLastError がS_OKを返す場合にのみ、lppMAPIError パラメーターで使用できます。 場合によっては、MAPI で最後のエラーが何であったのかを判断できない場合や、エラーについて報告するものが他にありません。 この状況では、 代わりに lppMAPIError は NULL へのポインターを返します。
GetLastError メソッドの詳細については、「MAPI 拡張エラー」を参照してください。
MAPI によって割り当てられたすべてのメモリを解放するには、返された MAPIERROR 構造体の MAPIFreeBuffer 関数を呼び出します。