Home Library Learn Samples Downloads Support Community Forums
This topic has not yet been rated - Rate this topic

IMsgServiceAdmin::GetLastError

Office 2013

Published: July 16, 2012

Returns a MAPIERROR structure that contains information about the last error that occurred for a message service administration object.

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

[in] An HRESULT data type that contains the error value generated by 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 the returned MAPIERROR structure that contains version, component, and context information for the error. The lppMAPIError parameter can be set to NULL if there is no MAPIERROR structure to return.

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 message service administration object does not support Unicode.

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.

You can make use of 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 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 Using Extended Errors.

Did you find this helpful?
(1500 characters remaining)
© 2013 Microsoft. All rights reserved.