Freigeben über


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 wird, 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 keine MAPIERROR zurückgegeben werden 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

Verwenden Sie die IMSLogon::GetLastError-Methode, um Informationen abzurufen, die dem Benutzer in einer Meldung bezüglich des letzten Fehlers angezeigt werden, der von einem Methodenaufruf für das Nachrichtenspeicherobjekt zurückgegeben wurde.

Um den gesamten von MAPI zugewiesenen Arbeitsspeicher für die zurückgegebene MAPIERROR-Struktur freizugeben, müssen Clientanwendungen nur die MAPIFreeBuffer-Funktion aufrufen.

Der Rückgabewert von GetLastError muss S_OK sein, damit eine Anwendung MAPIERRORverwenden kann. Selbst wenn der Rückgabewert S_OK ist, wird möglicherweise kein MAPIERROR zurückgegeben. Wenn die Implementierung nicht ermitteln kann, was der letzte Fehler war, oder wenn ein MAPIERROR für diesen Fehler nicht verfügbar ist, gibt GetLastError stattdessen einen Zeiger auf NULL in lppMAPIError zurück.

Siehe auch

MAPIERROR

MAPIFreeBuffer

IMSLogon : IUnknown