IMsgServiceAdmin::GetLastErrorIMsgServiceAdmin::GetLastError

適用されます: OutlookApplies to: Outlook

メッセージ サービスの管理オブジェクトに対して発生した最後のエラーに関する情報を格納するMAPIERROR構造体を返します。Returns a MAPIERROR structure that contains information about the last error that occurred for a message service administration 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 by 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 the returned MAPIERROR structure that contains version, component, and context information for the error. 取得するMAPIERROR構造体がない場合、 _lppMAPIError_パラメーターを NULL に設定できます。The lppMAPIError parameter can be set to NULL if there is no MAPIERROR structure to return.

�߂�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 をサポートしていません。The MAPI_UNICODE flag was set and the message service administration object does not support Unicode.

備考Remarks

IMsgServiceAdmin::GetLastErrorメソッドは、 IMsgServiceAdminメソッドの呼び出しによって返された最後のエラーに関する情報を取得します。The IMsgServiceAdmin::GetLastError method retrieves information about the last error that was returned by an IMsgServiceAdmin method call. クライアントは、ダイアログ ボックスでこの情報を含めることによって、エラーの詳細情報をユーザーを提供できます。Clients can provide their users with detailed information about the error by including this information in a dialog box.

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

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

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

関連項目See also

MAPIERRORMAPIERROR

MAPIFreeBufferMAPIFreeBuffer

IMsgServiceAdmin: IUnknownIMsgServiceAdmin : IUnknown