GetErrorInfo-Funktion (oleauto.h)

  • Artikel

Ruft den Fehlerinformationszeiger ab, der durch den vorherigen Aufruf von SetErrorInfo im aktuellen logischen Thread festgelegt wurde.

Syntax

HRESULT GetErrorInfo(
  [in]  ULONG      dwReserved,
  [out] IErrorInfo **pperrinfo
);

Parameter

[in] dwReserved

Für die zukünftige Verwendung reserviert. Muss Null sein.

[out] pperrinfo

Ein Fehlerobjekt.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.
S_FALSE
 Es wurde kein Fehlerobjekt zurückgegeben.

Hinweise

Diese Funktion gibt einen Zeiger auf den zuletzt festgelegten IErrorInfo-Zeiger im aktuellen logischen Thread zurück. Er überträgt den Besitz des Fehlerobjekts an den Aufrufer und löscht den Fehlerstatus für den Thread.

Durch einen COM-Aufruf, der einen Proxy-Stub durchläuft, wird jedes vorhandene Fehlerobjekt für den aufrufenden Thread gelöscht. Ein aufgerufenes -Objekt sollte nach dem Aufruf von SetErrorInfo und vor der Rückgabe keine solchen Aufrufe ausführen. Der Aufrufer sollte nach der Rückgabe des Aufrufs und vor dem Aufruf von GetErrorInfo keine solchen Aufrufe tätigen. Als Faustregel sollte eine Schnittstellenmethode nach dem Aufruf von SetErrorInfo so schnell wie möglich zurückgegeben werden, und der Aufrufer sollte GetErrorInfo so bald wie möglich aufrufen, nachdem der Aufruf zurückgegeben wurde.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile oleauto.h
Bibliothek OleAut32.lib
DLL OleAut32.dll