IPersistMessage::GetLastErrorIPersistMessage::GetLastError

適用されます: OutlookApplies to: Outlook

フォーム オブジェクトでは、前のエラーに関する情報を格納するMAPIERROR構造体を返します。Returns a MAPIERROR structure that contains information about the previous error in the form object.

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

ParametersParameters

hResulthResult

[in]以前のメソッドの呼び出しで生成されたエラー値を含む HRESULT のデータ型です。[in] An HRESULT data type that contains the error value generated in the previous method call.

ulFlagsulFlags

[in]返される文字列の種類を制御するフラグのビットマスクです。[in] A bitmask of flags that controls the type of strings returned. 次のフラグを設定することができます。The following flag can be set:

MAPI_UNICODEMAPI_UNICODE

_LppMAPIError_パラメーターに返されたMAPIERROR構造体の文字列は、Unicode 形式では。The strings in the MAPIERROR structure returned in the lppMAPIError parameter are in Unicode format. MAPI_UNICODE フラグが設定されていない場合は、ANSI 形式の文字列です。If the MAPI_UNICODE flag is not set, the strings are in ANSI format.

lppMAPIErrorlppMAPIError

[out]エラーのバージョン、コンポーネント、およびコンテキストの情報を格納するMAPIERROR構造体へのポインターへのポインター。[out] A pointer to a pointer to a MAPIERROR structure that contains version, component, and context information for the error. フォームは、 MAPIERROR構造体の適切な情報を提供できない場合、 _lppMAPIError_パラメーターを NULL に設定できます。The lppMAPIError parameter can be set to NULL if the form cannot supply appropriate information for a MAPIERROR structure.

�߂�lReturn value

S_OKS_OK

�ʘb���������A�\�������l�܂��͒l���Ԃ���܂��BThe call succeeded and has returned the expected value or values.

MAPI_E_BAD_CHARWIDTHMAPI_E_BAD_CHARWIDTH

MAPI_UNICODE フラグが設定されたアドレス帳プロバイダーが Unicode をサポートしていないまたは MAPI_UNICODE が設定されていませんでしたし、アドレス帳プロバイダーは、Unicode だけをサポートしています。Either the MAPI_UNICODE flag was set and the address book provider does not support Unicode, or MAPI_UNICODE was not set and the address book provider supports only Unicode.

備考Remarks

フォーム オブジェクトでは、失敗したメソッド呼び出しに関する情報を提供するIPersistMessage::GetLastErrorメソッドを実装します。Form objects implement the IPersistMessage::GetLastError method to supply information about a prior method call that failed. フォーム ビューアーは、ダイアログ ボックスにMAPIERROR構造体のデータを含めることによって、ユーザーにエラーに関する詳細な情報を提供できます。Form viewers can provide their users with detailed information about the error by including the data from the MAPIERROR structure in a dialog box.

GetLastErrorの呼び出しは、フォームの状態には影響しません。A call to GetLastError does not affect the state of the form. GetLastErrorから制御が戻るとき、フォームは、呼び出しが行われた前の状態には。When GetLastError returns, the form remains in the state that it was in before the call was made.

呼び出し側への注意Notes to callers

フォームが用意されて、1 つが発生しましたが S_OK を返す場合にのみ、 _lppMAPIError_パラメーターで示される場合は、 MAPIERROR構造体を使用できます。You can use the MAPIERROR structure, if the form supplies one, that is pointed to by the lppMAPIError parameter only if GetLastError returns S_OK. どのような最後のエラーまたはエラーを報告するのにはそれ以上には、フォームは判断できません。Sometimes the form cannot determine what the last error was or has nothing more to report about the error. このような場合は、フォームにポインターを返します NULL _lppMAPIError_の代わりにします。In this situation, the form returns a pointer to NULL in lppMAPIError instead.

GetLastErrorメソッドの詳細については、 MAPI の拡張エラーを参照してください。For more information about the GetLastError method, see MAPI Extended Errors.

関連項目See also

MAPIERRORMAPIERROR

MAPIFreeBufferMAPIFreeBuffer

IPersistMessage: IUnknownIPersistMessage : IUnknown