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 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 eine MAPIERROR-Struktur , die Versions-, Komponenten- und Kontextinformationen für den Fehler enthält. Der lppMAPIError-Parameter 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 das flag MAPI_UNICODE festgelegt, und der Adressbuchanbieter unterstützt Unicode nicht, oder MAPI_UNICODE wurde nicht festgelegt und der Adressbuchanbieter unterstützt nur Unicode.
Hinweise
Formularobjekte implementieren die IPersistMessage::GetLastError-Methode , um Informationen zu einem vorherigen Methodenaufruf anzugeben, bei dem ein Fehler aufgetreten ist. Formular-Viewer können ihren Benutzern detaillierte Informationen zum Fehler bereitstellen, indem sie die Daten aus der MAPIERROR-Struktur in ein Dialogfeld einschließen.
Ein Aufruf von GetLastError wirkt sich nicht auf den Zustand 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 bereitstellt, auf die der lppMAPIError-Parameter nur verweist, wenn GetLastError S_OK zurückgibt. Manchmal kann das Formular nicht bestimmen, was der letzte Fehler war, oder hat nichts mehr zu melden über den Fehler. In diesem Fall gibt das Formular stattdessen einen Zeiger auf NULL in lppMAPIError zurück.
Weitere Informationen zur GetLastError-Methode finden Sie unter MAPI Extended Errors.