Freigeben über


IMAPIControl::GetLastError

Gilt für: Outlook 2013 | Outlook 2016

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

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

Parameter

hResult

[in] Ein Handle für den Fehlerwert, 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 der Anbieter keine MAPIERROR-Struktur mit entsprechenden Informationen 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 MAPI_UNICODE-Flag festgelegt und die Implementierung unterstützt kein Unicode, oder MAPI_UNICODE wurde nicht festgelegt und die Implementierung unterstützt nur Unicode.

Hinweise

Dienstanbieter implementieren die IMAPIControl::GetLastError-Methode, um Informationen zu einem früheren Methodenaufruf anzugeben, bei dem ein Fehler aufgetreten ist. MAPI kann Benutzern detaillierte Informationen zu dem Fehler bereitstellen, indem die Daten aus der MAPIERROR-Struktur in einer Nachricht oder einem Dialogfeld angezeigt werden.

Hinweise für Implementierer

Sie benötigen keine Informationen, die in die MAPIERROR-Struktur für jeden Fehler eingeschlossen werden müssen. Es kann möglicherweise nicht ermittelt werden, was der vorherige Fehler war. Wenn Sie über Informationen verfügen, geben Sie S_OK und die entsprechenden Daten in der MAPIERROR--Struktur zurück. Wenn keine Informationen verfügbar sind, geben Sie S_OK und einen Zeiger auf NULL für den Parameter lppMAPIError zurück.

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

Siehe auch

MAPIERROR

MAPIFreeBuffer

IMAPIControl : IUnknown