HRESULT 0x80000000 – wyjątek COM, ExternalException, instalatory, sterowniki, .NET, C++

Pytanie

Wyjątek od HRESULT: 0x80000000

Odpowiedź Sztucznej Inteligencji

Bezpośrednia odpowiedź na pytanie

• „Exception from HRESULT: 0x80000000” oznacza, że kod zwrócony jako HRESULT ma ustawiony bit „error” (najstarszy), ale pozostałe pola (facility i code) są równe zero. To nie jest standardowy, nazwany błąd Windows (nie mylić z 0x80004005 E_FAIL ani 0x8000FFFF E_UNEXPECTED).
• Najczęściej jest to skutek: błędnego mapowania wartości zwrotnych (np. nieprawidłowa translacja Win32 → HRESULT), niezainicjalizowanej zmiennej HRESULT, ręcznie rzuconego COMException/ExternalException z tą wartością lub awarii/niezgodności interfejsów COM/interop.

Kluczowe punkty:

• 0x80000000 = -2147483648 (min. 32‑bit signed), severity=1, facility=0, code=0.
• Brak oficjalnej nazwy w winerror.h; to „surowy” błąd.
• Diagnostyka zależy od kontekstu (instalator/sterownik, interop .NET/COM, natywny C/C++/PInvoke).

Szczegółowa analiza problemu

• Struktura HRESULT (32 bity): bit 31 = severity (1=błąd), bity 16–30 = facility (źródło), bity 0–15 = code (szczegół). Dla 0x80000000: severity=1, facility=0, code=0, a więc brak informacji o źródle i numerze błędu.
• Dlaczego to się pojawia?
  • Nieprawidłowa translacja błędu: np. użycie MAKE_HRESULT lub własnego wrappera, który zwraca MAKE_HRESULT(SEVERITY_ERROR, 0, 0).
  • Niezainicjalizowany HRESULT w natywnym kodzie (losowa wartość może przyjąć MININT).
  • Ręczne rzucenie wyjątku z MININT (np. new COMException(unchecked((int)0x80000000))).
  • COM/interop: niezgodność marshalingu (błędne StructLayout, Pack, CharSet, podpis metody), różnica x86/x64, proxy/stub mismatch – serwer nie zwraca prawidłowego błędu i po stronie klienta ląduje „nagie” 0x80000000.
  • Instalatory/sterowniki: proces kończy się błędem, ale logger nie mapuje go na kod MSI/Win32 → na wierzchu widać generyczne 0x80000000.
• Czego ten kod nie oznacza:
  • Nie jest równoznaczny z 0x80004005 (E_FAIL) ani z 0x8000FFFF (E_UNEXPECTED).
  • Nie pochodzi z makra HRESULT_FROM_WIN32 dla typowych błędów Win32 (tam zwykle facility=7 i widać 0x8007XXXX; dla 0 zwraca S_OK, nie 0x80000000).

Praktyczne zastosowania/konsekwencje:

• W .NET to zwykle COMException/ExternalException. Leczenie „w ciemno” (reinstalacje, SFC) pomaga rzadko; kluczowy jest kontekst i stack trace.
• W natywnym C/C++: zainicjalizuj zawsze HRESULT (S_OK), propaguj prawdziwe kody (np. E_POINTER, E_INVALIDARG), a Win32 mapuj poprawnie (HRESULT_FROM_WIN32(GetLastError())).

Aktualne informacje i trendy

• W realnych incydentach 0x80000000 bywa widziane przy nieudanych instalacjach sterowników/oprogramowania i problemach interop, gdzie logi producenta nie tłumaczą błędu na kod Win32/HRESULT z facility ≠ 0. Najlepszą praktyką jest włączenie pełnego logowania (MSI /L*V, SetupAPI.dev.log, ETW) i wychwycenie pierwotnego kodu przed „spłaszczeniem” do 0x80000000.
• Trend: coraz większe znaczenie poprawnego marshalingu w mieszanych środowiskach (C++/CLI, .NET 6/8, WinRT, COM) i automatyczne generowanie proxy – błędne atrybuty struktury to częsta przyczyna trudnych błędów.

Wspierające wyjaśnienia i detale

• Szybki dekoder HRESULT (PowerShell):
  • $hr = 0x80000000; "{0} sev={1} fac={2} code={3}" -f ('0x{0:X8}' -f $hr), (($hr -shr 31) -band 1), (($hr -shr 16) -band 0x1FFF), ($hr -band 0xFFFF)
  • Wynik: sev=1, fac=0, code=0.
• W .NET:
  • Sprawdź Exception.HResult, InnerException, Data, HelpLink, Source.
  • Włącz „Break on thrown” dla System.Runtime.InteropServices.COMException (Exception Settings).
  • Jeśli to ładowanie zestawów: włącz dzienniki ładowania (Fusion logs) lub EventPipe/ETW (dotnet-trace, PerfView).
• W COM:
  • Zweryfikuj zgodność interfejsów (OLE/IDL), typów VARIANT, BSTR vs LPWSTR, alignment i Pack.
  • Sprawdź rejestrację serwera COM, biblioteki typów (OleView), zgodność bitness (x86 vs x64).
• Instalatory/sterowniki:
  • MSI: uruchom instalację z logiem: msiexec /i pakiet.msi /L*V log.txt.
  • Sterowniki: przejrzyj %windir%\inf\setupapi.dev.log; użyj pnputil /enum-drivers i pnputil /add-driver.
  • Uprawnienia/podpis: Secure Boot, podpis katalogu (.cat), polityki GPO blokujące instalację.

Aspekty etyczne i prawne

• Zachowuj integralność i poufność logów (mogą zawierać PII).
• Sterowniki muszą być podpisane (Windows Driver Signing); obchodzenie zabezpieczeń testowych tylko w środowisku deweloperskim.
• Dumpy pamięci i telemetry zbieraj zgodnie z polityką prywatności.

Praktyczne wskazówki

• Najpierw kontekst:
  • Kiedy pojawia się błąd (instalacja, start aplikacji, konkretna funkcja)?
  • Jaki stos technologiczny (.NET wersja, natywne C/C++, P/Invoke, COM, WinRT)?
  • Czy błąd jest replikowalny na innej maszynie/koncie?
• Ścieżka diagnostyczna (minimalna, skuteczna):
  1. Złap pełny stack trace i InnerException; włącz „Break on thrown” dla COMException.
  2. Zaloguj pierwotny kod Win32 (GetLastError) i mapowanie do HRESULT (sprawdź, czy nie powstaje 0x80000000 przez własny wrapper).
  3. Jeśli interop/COM: sprawdź deklaracje [StructLayout], szerokość/alignment pól, typy łańcuchów, a także bitness zgodny między klientem a serwerem.
  4. Jeśli instalator/sterownik: wygeneruj log MSI i SetupAPI.dev.log; zweryfikuj podpisy i uprawnienia admina.
  5. Upewnij się, że wszystkie zmienne HRESULT są inicjalizowane i że zwracasz kody z właściwym facility (np. FACILITY_WIN32).
• Szybkie „anty‑pułapki” w kodzie:
  • Nie rzuć „gołego” 0x80000000 – użyj zdefiniowanych E_* albo HRESULT_FROM_WIN32(x).
  • Nie wywołuj Marshal.GetHRForLastWin32Error() bez wcześniejszego SetLastError=true i realnego błędu.
  • Waliduj marshalling struktur (SizeOf, Pack=1/8 zgodny z natywnym ABI).

Ewentualne zastrzeżenia lub uwagi dodatkowe

• Rzadko, gdy błąd jest całkowicie losowy i bez korelacji z operacją, warto wykluczyć niestabilność sprzętową (RAM, zasilanie) – ale to ostatni trop po wyczerpaniu przyczyn programistycznych.
• Brak symbolicznej nazwy dla 0x80000000 utrudnia automatyczne diagnozy – stąd tak ważny jest pierwotny log.

Sugestie dalszych badań

• Dokumentacja HRESULT i dobre praktyki mapowania Win32 → HRESULT (FACILITY_WIN32).
• Narzędzia: ProcMon (filtr na RESULT/HRESULT), ETW (Windows Performance Recorder/Analyzer), WinDbg/Visual Studio (first‑chance COMException), PerfView/dotnet-trace.
• W COM: przegląd IDL/OleView, testy interfejsów z PInvoke Interop Assistant.

Krótkie podsumowanie

• 0x80000000 to „nagie” HRESULT sygnalizujące błąd bez informacji o źródle i numerze – zwykle skutek błędnej translacji/propagacji błędu lub niepoprawnego interop/COM. Najskuteczniejsza droga to uchwycenie pierwotnego błędu (stack, logi MSI/SetupAPI, ETW), weryfikacja marshalling’u i poprawne mapowanie kodów.

Jeśli podasz:

• dokładny scenariusz (co robisz, gdy błąd występuje),
• środowisko (.NET/wersja, natywny C/C++, architektura x86/x64),
• fragment stosu/komunikatu,
  to przygotuję precyzyjną listę kroków i ewentualnych poprawek w kodzie/konfiguracji.