Freigeben über


IMAPISupport::GetLastError

Gilt für: Outlook 2013 | Outlook 2016

Gibt eine MAPIERROR-Struktur zurück, die Informationen zum vorherigen Supportobjektfehler enthält.

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

Parameter

Hresult

[in] Ein Handle für den Fehlerwert, der im vorherigen Methodenaufruf für das Supportobjekt generiert wurde.

ulFlags

[in] Eine Bitmaske von Flags, die den Typ der zurückgegebenen Zeichenfolgen steuert. Das folgende Flag kann festgelegt werden:

MAPI_UNICODE

Die Zeichenfolgen in der MAPIERROR-Struktur , die im lppMAPIError-Parameter zurückgegeben werden, weisen das Unicode-Format auf. Wenn das MAPI_UNICODE-Flag nicht festgelegt ist, liegen die Zeichenfolgen im ANSI-Format vor.

lppMAPIError

[out] Ein Zeiger auf einen Zeiger auf die MAPIERROR-Struktur , die Versions-, Komponenten- und Kontextinformationen für den Fehler enthält. Der Parameter lppMAPIError kann auf NULL festgelegt werden, wenn keine MAPIERROR-Struktur mit entsprechenden Fehlerinformationen bereitgestellt werden kann.

Rückgabewert

S_OK

Der Aufruf war erfolgreich und hat den erwarteten Wert oder die erwarteten Werte zurückgegeben.

MAPI_E_BAD_CHARWIDTH

Entweder wurde das MAPI_UNICODE-Flag festgelegt, und MAPI unterstützt Unicode nicht, oder MAPI_UNICODE wurde nicht festgelegt und MAPI unterstützt nur Unicode.

Hinweise

Die IMAPISupport::GetLastError-Methode wird für alle Unterstützungsobjekte implementiert. Aufrufer können ihren Benutzern detaillierte Informationen zum Fehler bereitstellen, indem sie die Daten aus der MAPIERROR-Struktur in ein Dialogfeld einschließen.

Hinweise für Aufrufer

Sie können den Zeiger auf die MAPIERROR-Struktur im lppMAPIError-Parameter nur verwenden, wenn GetLastError S_OK zurückgibt, sofern MAPI eine dieser Parameter bereitstellt. Manchmal kann MAPI nicht ermitteln, was der letzte Fehler war, oder sie hat nichts mehr über den Fehler zu melden. In diesem Fall gibt lppMAPIError stattdessen einen Zeiger auf NULL zurück.

Weitere Informationen zur GetLastError-Methode finden Sie unter MAPI Extended Errors.

Um den gesamten von MAPI zugeordneten Arbeitsspeicher freizugeben, rufen Sie die MAPIFreeBuffer-Funktion für die zurückgegebene MAPIERROR-Struktur auf.

Siehe auch

MAPIERROR
MAPIFreeBuffer
IMAPISupport : IUnknownMAPI Extended Errors