HRESULT-Werte

Im Folgenden finden Sie eine Liste der allgemeinen Rückgabewerte für Funktionen und Methoden und deren üblichen Bedeutungen.

Erfolgreiche Ergebnisse. Diese Werte werden in WinError.h definiert.

S_OK
Erfolgreicher Abschluss.

S_FALSE
Ohne Fehler abgeschlossen, aber es wurden nur Teilergebnisse abgerufen.

Wenn ein Puffer nicht groß genug ist, um die an ihn zurückgegebenen Informationen zu enthalten, werden die zurückgegebenen Informationen häufig abgeschnitten, damit sie in den Puffer passen, und S_FALSE wird von der -Methode zurückgegeben.

Fehlerergebnisse. Diese Werte werden in WinError.h definiert.

E_FAIL
Der Vorgang konnte nicht ausgeführt werden.

E_INVALIDARG
Eines der übergebenen Argumente war ungültig.

E_NOINTERFACE
Das gesuchte Objekt wurde nicht gefunden.

E_OUTOFMEMORY
Fehler bei einem Speicherbelegungsversuch.

E_UNEXPECTED
Auf das Ziel kann nicht zugegriffen werden, oder die Engine befand sich nicht in einem Zustand, in dem die Funktion oder Methode verarbeitet werden konnte.

E_NOTIMPL
Nicht implementiert.

HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED)
Der Vorgang wurde verweigert, weil sich der Debugger im sicheren Modus befindet.

NT-Fehlerergebnisse. Andere Fehlercodes, z. B. STATUS_CONTROL_C_EXIT und STATUS_NO_MORE_ENTRIES, können manchmal auftreten. Diese Ergebnisse werden an das HRESULT_FROM_NT Makro übergeben, das in WinError.h definiert ist, bevor sie zurückgegeben werden.

Win32-Fehlerergebnisse. Andere Fehlercodes, z. B. ERROR_READ_FAULT und ERROR_WRITE_FAULT, können manchmal auftreten. Diese Ergebnisse werden an das HRESULT_FROM_WIN32 Makro übergeben, das in WinError.h definiert ist, bevor sie zurückgegeben werden.

Anforderungen