IMSLogon::GetLastError
Gilt für: Outlook 2013 | Outlook 2016
Gibt eine MAPIERROR-Struktur zurück, die Informationen zum letzten Fehler enthält, der für das Nachrichtenspeicherobjekt aufgetreten ist.
HRESULT GetLastError(
HRESULT hResult,
ULONG ulFlags,
LPMAPIERROR FAR * lppMAPIError
);
Parameter
Hresult
[in] Ein HRESULT-Datentyp, der den Fehlerwert enthält, der im vorherigen Methodenaufruf für das Nachrichtenspeicherobjekt 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 zurückgegebene MAPIERROR-Struktur , die Versions-, Komponenten- und Kontextinformationen für den Fehler enthält. Der Parameter lppMAPIError kann auf NULL festgelegt werden, wenn kein MAPIERROR zurückgegeben werden soll.
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 die Implementierung unterstützt Unicode nicht, oder MAPI_UNICODE wurde nicht festgelegt und die Implementierung unterstützt nur Unicode.
Hinweise
Verwenden Sie die IMSLogon::GetLastError-Methode , um Informationen abzurufen, die dem Benutzer in einer Meldung angezeigt werden, die den letzten Fehler betreffen, der von einem Methodenaufruf für das Nachrichtenspeicherobjekt zurückgegeben wurde.
Um den gesamten von MAPI für die zurückgegebene MAPIERROR-Struktur zugeordneten Arbeitsspeicher freizugeben, müssen Clientanwendungen nur die MAPIFreeBuffer-Funktion aufrufen.
Der Rückgabewert von GetLastError muss S_OK werden, damit eine Anwendung MAPIERROR verwenden kann. Selbst wenn der Rückgabewert S_OK ist, wird möglicherweise kein MAPIERROR zurückgegeben. Wenn die Implementierung den letzten Fehler nicht ermitteln kann oder wenn für diesen Fehler kein MAPIERROR verfügbar ist, gibt GetLastError stattdessen in lppMAPIError einen Zeiger auf NULL zurück.