IMAPIProp::GetLastError
Gilt für: Outlook 2013 | Outlook 2016
Gibt eine MAPIERROR-Struktur zurück, die Informationen zum vorherigen Fehler enthält.
HRESULT GetLastError(
HRESULT hResult,
ULONG ulFlags,
LPMAPIERROR FAR * lppMAPIError
);
Parameter
Hresult
[in] Ein Handle für den Fehlercode, der im vorherigen Methodenaufruf generiert wurde.
ulFlags
[in] Eine Bitmaske von Flags, die das Format für den Text angibt, der in der MAPIERROR-Struktur zurückgegeben wird, auf die von lppMAPIError gezeigt wird. Das folgende Flag kann festgelegt werden:
MAPI_UNICODE
Die Zeichenfolgen sollten im Unicode-Format vorliegen. Wenn das MAPI_UNICODE-Flag nicht festgelegt ist, sollten die Zeichenfolgen im ANSI-Format vorliegen.
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 Fehlerinformationen zurückgegeben werden sollen.
Rückgabewert
S_OK
Die Fehlerinformationen wurden zurückgegeben.
MAPI_E_BAD_CHARWIDTH
Entweder wurde das flag MAPI_UNICODE festgelegt, und die Implementierung unterstützt Unicode nicht, oder MAPI_UNICODE wurde nicht festgelegt und die Implementierung unterstützt nur Unicode.
Hinweise
Die IMAPIProp::GetLastError-Methode stellt Informationen zu einem vorherigen Methodenaufruf bereit, bei dem ein Fehler aufgetreten ist. Clients können ihren Benutzern ausführliche Informationen zum Fehler bereitstellen, indem sie die Daten aus der MAPIERROR-Struktur in ein Dialogfeld einschließen.
Alle von MAPI bereitgestellten GetLastError-Implementierungen sind ANSI-Implementierungen, mit Ausnahme der IAddrBook-Implementierung . Die in IAddrBook enthaltene GetLastError-Methode unterstützt Unicode.
Hinweise für Implementierer
Die Details zur Implementierung dieser Methode durch einen Remotetransportanbieter und zu den Nachrichten, die diese Methode zurückgibt, liegen beim Transportanbieter, da die besonderen Fehlerbedingungen, die zu verschiedenen HRESULT-Werten führen, für verschiedene Transportanbieter unterschiedlich sind.
Hinweise für Aufrufer
Sie können die MAPIERROR-Struktur verwenden, auf die der lppMAPIError-Parameter verweist, wenn GetLastError einen bereitstellt, nur, wenn der Rückgabewert S_OK ist. Manchmal kann GetLastError nicht ermitteln, was der letzte Fehler war, oder hat nichts mehr über den Fehler zu melden. In diesem Fall wird stattdessen ein Zeiger auf NULL in lppMAPIError zurückgegeben.
Um den Arbeitsspeicher für die MAPIERROR-Struktur freizugeben, rufen Sie die MAPIFreeBuffer-Funktion auf.
Weitere Informationen zur GetLastError-Methode finden Sie unter MAPI Extended Errors.