This topic has not yet been rated - Rate this topic

IMAPISession::GetLastError

Office 2007

Returns a MAPIERROR structure that contains information about the previous session error.

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

Parameters

hResult: [in] A handle to the error value generated in the previous method call.

ulFlags

[in] A bitmask of flags that controls the type of strings returned. The following flag can be set:

MAPI_UNICODE: The strings in the MAPIERROR structure returned in the lppMAPIError parameter are in Unicode format. If the MAPI_UNICODE flag is not set, the strings are in ANSI format.

lppMAPIError: [out] A pointer to a pointer to a MAPIERROR structure that contains version, component, and context information for the error. The lppMAPIError parameter can be set to NULL if MAPI cannot supply appropriate information for a MAPIERROR structure.

Return Value

S_OK: The call succeeded and has returned the expected value or values.

MAPI_E_BAD_CHARWIDTH: The MAPI_UNICODE flag was set and the session does not support Unicode.

Remarks

The IMAPISession::GetLastError method retrieves information about the last error that was returned by an IMAPISession method call. Clients can provide their users with detailed information about the error by including this information in a dialog box.

Notes to Callers

You can use the MAPIERROR structure, if MAPI supplies one, pointed to by the lppMAPIError parameter only if GetLastError returns S_OK. Sometimes MAPI cannot determine what the last error was, or it has nothing more to report about the error. In this situation, GetLastError returns a pointer to NULL in lppMAPIError instead.

For more information about the GetLastError method, see MAPI Extended Errors.

Reference

MAPIERROR
MAPIFreeBuffer
IMAPISession : IUnknown

Concepts

MAPI Extended Errors

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)