IPersistMessage::GetLastError

Gilt für: Outlook 2013 | Outlook 2016

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

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

Parameter

hResult

[in] Ein HRESULT-Datentyp, der den Fehlerwert enthält, der im vorherigen Methodenaufruf 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 wird, weisen das Unicode-Format auf. Wenn die MAPI_UNICODE-Kennzeichnung nicht festgelegt ist, liegen die Zeichenfolgen im ANSI-Format vor.

lppMAPIError

[out] Ein Zeiger auf einen Zeiger auf eine MAPIERROR-Struktur, die Versions-, Komponenten- und Kontextinformationen für den Fehler enthält. Der Parameter lppMAPIError kann auf NULL festgelegt werden, wenn das Formular keine geeigneten Informationen für eine MAPIERROR-Struktur bereitstellen kann.

Rückgabewert

S_OK

Der Aufruf erfolgreich ausgeführt und der erwartete Wert oder Werte zurückgegeben hat.

MAPI_E_BAD_CHARWIDTH

Entweder wurde die MAPI_UNICODE-Kennzeichnung gesetzt und der Adressbuchanbieter unterstützt Unicode nicht, oder MAPI_UNICODE wurde nicht gesetzt und der Adressbuchanbieter unterstützt nur Unicode.

Hinweise

Formularobjekte implementieren die IPersistMessage::GetLastError-Methode, um Informationen zu einem früheren Methodenaufruf anzugeben, bei dem ein Fehler aufgetreten ist. Formularanzeigen können ihren Benutzern detaillierte Informationen zum Fehler bereitstellen, indem sie die Daten aus der MAPIERROR-Struktur in ein Dialogfeld einschließen.

Ein Aufruf GetLastError wirkt sich nicht auf den Status des Formulars aus. Wenn GetLastError zurückgegeben wird, verbleibt das Formular in dem Zustand, in dem es sich vor dem Aufruf befand.

Hinweise für Aufrufer

Sie können die MAPIERROR-Struktur verwenden, wenn das Formular eine Struktur bereitstellt, auf die der lppMAPIError-Parameter zeigt, nur, wenn GetLastError S_OK zurückgibt. Manchmal kann das Formular nicht bestimmen, was der letzte Fehler war, oder hat nichts mehr über den Fehler zu berichten. In diesem Fall gibt das Formular stattdessen einen Zeiger auf NULL in lppMAPIError zurück.

Weitere Informationen zur Methode GetLastError finden Sie unter MAPI Erweiterte Fehler.

Siehe auch

MAPIERROR

MAPIFreeBuffer

IPersistMessage : IUnknown