IPersistMessage::GetLastError

適用対象: Outlook 2013 | Outlook 2016

フォーム オブジェクト内の前のエラーに関する情報を含む MAPIERROR 構造体を返します。

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

パラメーター

Hresult

[in]前のメソッド呼び出しで生成されたエラー値を含む HRESULT データ型。

ulFlags

[in]返される文字列の種類を制御するフラグのビットマスク。 次のフラグを設定できます。

MAPI_UNICODE

lppMAPIError パラメーターで返される MAPIERROR 構造体の文字列は Unicode 形式です。 MAPI_UNICODE フラグが設定されていない場合、文字列は ANSI 形式です。

lppMAPIError

[out]エラーのバージョン、コンポーネント、コンテキスト情報を含む MAPIERROR 構造体へのポインターへのポインター。 フォームが MAPIERROR 構造体の適切な情報を提供できない場合は、lppMAPIError パラメーターを NULL に設定できます。

戻り値

S_OK

�ʘb���������A�\�������l�܂��͒l���Ԃ���܂��B

MAPI_E_BAD_CHARWIDTH

MAPI_UNICODE フラグが設定され、アドレス帳プロバイダーが Unicode をサポートしていないか、MAPI_UNICODEが設定されておらず、アドレス帳プロバイダーが Unicode のみをサポートしています。

注釈

フォーム オブジェクトは IPersistMessage::GetLastError メソッドを実装し、失敗した以前のメソッド呼び出しに関する情報を提供します。 フォーム ビューアーは、 MAPIERROR 構造体のデータをダイアログ ボックスに含めることで、エラーに関する詳細情報をユーザーに提供できます。

GetLastError の呼び出しは、フォームの状態には影響しません。 GetLastError が返された場合、フォームは呼び出しが行われる前の状態のままです。

呼び出し側への注意

フォームが提供する MAPIERROR 構造体を使用できます。これは、GetLastError がS_OKを返した場合にのみ、lppMAPIError パラメーターによって指されます。 場合によっては、フォームで最後のエラーが何であるかを判断できない場合や、エラーに関して報告するものが他にありません。 この状況では、フォームは代わりに lppMAPIError で NULL へのポインターを返します。

GetLastError メソッドの詳細については、「MAPI 拡張エラー」を参照してください。

関連項目

MAPIERROR

MAPIFreeBuffer

IPersistMessage : IUnknown