知識マップ: Windowsのエラーコードを読み解く ── Win32エラー・HRESULT・NTSTATUSの三層構造

記事「Windowsのエラーコードを読み解く ── Win32エラー・HRESULT・NTSTATUSの三層構造」の主張を、概念と関係(エッジ)に分解した知識グラフの全体です。各関係には根拠・確認日・確度が付いています。

Windowsのエラーコードは、Win32 APIが返すWin32エラーコード、COM以降のHRESULT、カーネル層のNTSTATUSという3体系に分かれます。現在のWindowsでは、カーネルがNTSTATUSを返し、Win32サブシステムがそれをWin32エラーコードへ変換し、COM層がさらにHRESULTへ包み直す流れが日常的に起きています。読解の最重要パターンは0x8007xxxxで、これはFACILITY_WIN32にWin32エラーコードを格納したものなので、下位16bitを10進に直せば本質のコードが分かります。一方0x80004005(E_FAIL)は「未指定の失敗」でしかなく、コード自体を深掘りしても得るものはありません。0xCで始まる8桁はNTSTATUSで、Nビットを立ててHRESULT空間へ持ち込めば0xDで始まる値になり、RtlNtStatusToDosErrorを通せばWin32エラーコードに丸められます。

flowchart LR
    accTitle: Windowsのエラーコード3体系の知識マップ
    accDescr: Win32エラーコード・HRESULT・NTSTATUSの3体系と、カーネルからWin32、COMへと包み直されていく変換の流れ、FacilityとHRESULT_FROM_WIN32による分解、NビットとRtlNtStatusToDosErrorによる橋渡し、.NET例外へのマップ、調査に使う変換ツールを示す図
    hresult["HRESULT"]
    win32_error_code["Win32エラーコード"]
    last_error_code["最終エラーコード(GetLastError)"]
    error_lookup_tool["err.exe(Microsoft Error Lookup Tool)"]
    certutil_error["certutil -error"]
    hresult_facility["HRESULTのFacility"]
    hresult_from_win32["HRESULT_FROM_WIN32"]
    e_fail["E_FAIL(0x80004005)"]
    ntstatus["NTSTATUS"]
    rtlntstatustodoserror["RtlNtStatusToDosError"]
    ntstatus_to_win32_conversion["NTSTATUSからWin32エラーコードへの変換"]
    hresult_nt_bit["HRESULTのNビット(HRESULT_FROM_NT)"]
    status_access_violation["STATUS_ACCESS_VIOLATION(0xC0000005)"]
    windows_event_log["Windowsイベントログ"]
    bug_check_code["バグチェックコード(STOPコード)"]
    procmon["Process Monitor(procmon.exe)"]
    windbg_error_command["WinDbgの!error"]
    windbg["WinDbg"]
    hresult_exception_mapping["HRESULTから.NET例外へのマップ"]
    marshal_getlastwin32error["Marshal.GetLastWin32Error"]
    win32_error_code -->|"に保存される"| last_error_code
    win32_error_code -->|"で確認できる"| error_lookup_tool
    win32_error_code -->|"で確認できる"| certutil_error
    hresult -->|"利用する"| hresult_facility
    hresult_from_win32 -->|"実装を担う"| hresult_facility
    hresult_from_win32 -->|"内容を継承する"| win32_error_code
    e_fail -->|"実装を担う"| hresult_facility
    ntstatus -->|"原因になり得る"| win32_error_code
    rtlntstatustodoserror -->|"実装を担う"| ntstatus_to_win32_conversion
    hresult_nt_bit -->|"内容を継承する"| ntstatus
    status_access_violation -->|"実装を担う"| ntstatus
    status_access_violation -->|"で確認できる"| windows_event_log
    ntstatus -->|"用いるのは非推奨"| bug_check_code
    ntstatus -.->|"で確認できる"| procmon
    ntstatus -->|"で確認できる"| windbg_error_command
    windbg_error_command -->|"実装を担う"| windbg
    hresult_exception_mapping -->|"内容を継承する"| hresult
    last_error_code -->|"で確認できる"| marshal_getlastwin32error

概念間の関係(全18件)

図と同じ関係を文章でも列挙します。表示している文と機械可読な意味データ(RDFa)は同じ要素に載っています。確度が「確立した関係」のものは直接の関係として、「条件付きの関係」のものは成立条件つきの言明(rdf:Statement)として表現しています。

Win32エラーコードは最終エラーコード(GetLastError)に保存されます。多くのWin32 APIは失敗を戻り値で示し、詳細なエラーコードはスレッドごとに保持される最終エラーコードに格納する。呼び出し側は失敗を確認した直後にGetLastErrorで取得する。成功時にコードを0で上書きするAPIとしないAPIが混在する点にも注意する。 / 確度: 確立した関係 / 確認日: 2026-08-20 出典
Win32エラーコードはerr.exe(Microsoft Error Lookup Tool)で確認できます。err.exeは16進のステータスコードに関連付けられたメッセージテキストを、Winerror.hなど各種ヘッダーファイルを横断して表示する。 / 確度: 確立した関係 / 確認日: 2026-08-20 出典
Win32エラーコードはcertutil -errorで確認できます。certutil -error は 0x80070002 (WIN32: 2 ERROR_FILE_NOT_FOUND) のように、シンボル名を含む形式でメッセージテキストを表示する。Windows標準なので追加インストールが要らない。 / 確度: 確立した関係 / 確認日: 2026-08-20 出典
HRESULTはHRESULTのFacilityを利用します。HRESULTは重大度のSビット、Customerビット、NTSTATUSマップを示すNビット、11bitのFacility、16bitのCodeというレイアウトで、発生源と詳細コードを1つの32bit値に詰めている。 / 確度: 確立した関係 / 確認日: 2026-08-20 出典出典
HRESULT_FROM_WIN32はHRESULTのFacilityの実装を担います。HRESULT_FROM_WIN32は下位16bitにWin32エラーコードを置き、FacilityにFACILITY_WIN32(7)を設定する。だから0x8007xxxxの下位16bitを10進に直せば本質のWin32エラーコードが取り出せる。 / 確度: 確立した関係 / 確認日: 2026-08-20 出典出典
HRESULT_FROM_WIN32はWin32エラーコードの内容を継承して表示します。Win32エラーコードしか返せない下位層の失敗を、HRESULTを返す上位層へ伝えるための包み直しである。 / 確度: 確立した関係 / 確認日: 2026-08-20 出典
E_FAIL(0x80004005)はHRESULTのFacilityの実装を担います。0x80004005はFacility=0(FACILITY_NULL)・Code=0x4005で、定義はE_FAIL「未指定の失敗」である。コード自体は詳細を報告できない失敗という意味しか持たないため、どのコンポーネントが返したかと同時刻のログへ調査の軸足を移す。 / 確度: 確立した関係 / 確認日: 2026-08-20 出典出典
NTSTATUSはWin32エラーコードの原因になることがあります。カーネルがNTSTATUSを返し、Win32サブシステムがそれをWin32エラーコードに変換し、COM層がさらにHRESULTへ包み直すという変換の流れが日常的に起きている。 / 確度: 確立した関係 / 確認日: 2026-08-20 出典出典
RtlNtStatusToDosErrorはNTSTATUSからWin32エラーコードへの変換の実装を担います。ntdllのRtlNtStatusToDosErrorがNTSTATUSを対応するWin32システムエラーコードへ変換し、対応が定義されていない値にはERROR_MR_MID_NOT_FOUNDを返す。カーネルの豊かな語彙がWin32層では粗い区分に丸められることがある。 / 確度: 確立した関係 / 確認日: 2026-08-22 出典
HRESULTのNビット(HRESULT_FROM_NT)はNTSTATUSの内容を継承して表示します。HRESULTのNビットを立てるとNTSTATUS値をそのままHRESULT空間へ持ち込める。0xDで始まるHRESULTを見たら、Nビットを外してNTSTATUSとして読むのが正しい手順になる。 / 確度: 確立した関係 / 確認日: 2026-08-20 出典
STATUS_ACCESS_VIOLATION(0xC0000005)はNTSTATUSの実装を担います。0xC0000005はエラー重大度(先頭が0xC)のNTSTATUSで、STATUS_DLL_NOT_FOUND(0xC0000135)・STATUS_STACK_OVERFLOW(0xC00000FD)・STATUS_HEAP_CORRUPTION(0xC0000374)と並ぶ代表値である。ブレークポイント例外の0x80000003は警告重大度になる。 / 確度: 確立した関係 / 確認日: 2026-08-20 出典出典
STATUS_ACCESS_VIOLATION(0xC0000005)はWindowsイベントログで確認できます。イベントログのApplication Error(イベントID 1000)に記録される「例外コード: 0xc0000005」がNTSTATUSである。 / 確度: 確立した関係 / 確認日: 2026-08-20 出典
NTSTATUSをバグチェックコード(STOPコード)に用いることは推奨されません。ブルースクリーンのSTOPコードは0x0000009F(DRIVER_POWER_STATE_FAILURE)のようにNTSTATUSとは別の独自番号体系で、専用のリファレンスを引く。NTSTATUSの表を引いてはいけない。 / 確度: 確立した関係 / 確認日: 2026-08-22 出典
NTSTATUSはProcess Monitor(procmon.exe)で確認できます。ProcmonのResult列に出るNAME NOT FOUNDやACCESS DENIEDは、カーネルが返したNTSTATUS(STATUS_OBJECT_NAME_NOT_FOUNDやSTATUS_ACCESS_DENIED)の表示名である。 / 確度: 条件付きの関係 / 確認日: 2026-08-20 出典
NTSTATUSはWinDbgの!errorで確認できます。WinDbgの!error拡張はWin32・Winsock・NTSTATUS・NetAPIのエラー値をデコードして表示し、フラグに1を指定するとNTSTATUSとして解釈する。 / 確度: 確立した関係 / 確認日: 2026-08-20 出典
WinDbgの!errorはWinDbgの実装を担います。!errorはWinDbgの拡張コマンドとして提供され、ダンプ解析中にそのままエラー値を引ける。 / 確度: 確立した関係 / 確認日: 2026-08-20 出典
HRESULTから.NET例外へのマップはHRESULTの内容を継承して表示します。既知のHRESULTはE_ACCESSDENIED→UnauthorizedAccessException、E_NOTIMPL→NotImplementedExceptionのように対応する例外型へ、明示的なマップがない値はCOMExceptionへ変換される。どの例外でも元のHRESULTはException.HResultに残る。 / 確度: 確立した関係 / 確認日: 2026-08-20 出典
最終エラーコード(GetLastError)はMarshal.GetLastWin32Errorで確認できます。SetLastErrorフラグを設定したP/Invoke呼び出しの最終エラーコードは、GetLastErrorを直接P/Invokeするのではなく、Marshal.GetLastWin32Errorで取得する。 / 確度: 確立した関係 / 確認日: 2026-08-22 出典

主要概念の定義

HRESULT: COMの呼び出し結果を表す32ビットの符号付き整数のエラーコード体系で、.NETの例外はHRESULTに対応付けられてCOM側へ伝わる。
Win32エラーコード: Win32 APIが失敗の詳細として返す0〜15999のシステムエラーコード。ERROR_ACCESS_DENIED(5)のようなシンボル名を持つ。
HRESULT_FROM_WIN32: Win32システムエラーコードをHRESULT値へマップするwinerror.hのマクロ。下位16bitにWin32エラーコード、FacilityにFACILITY_WIN32(7)、Sビットに1を設定する。
E_FAIL(0x80004005): FACILITY_NULLの汎用HRESULT。意味は「未指定の失敗(Unspecified failure)」で、それ以上の情報を持たない。
NTSTATUS: カーネル・デバイスドライバー・ntdllのネイティブAPIが使う32bitのステータスコード。上位2bitの重大度で成功・情報・警告・エラーを表す。
RtlNtStatusToDosError: NTSTATUSコードを対応するWin32システムエラーコードへ変換するntdllの関数。対応が定義されていない場合はERROR_MR_MID_NOT_FOUNDを返す。
HRESULTのNビット(HRESULT_FROM_NT): HRESULTのビット28。1のとき、その値がNTSTATUSをHRESULT空間へマップしたものであることを示す。
STATUS_ACCESS_VIOLATION(0xC0000005): 不正なメモリアクセスを示すNTSTATUS。アプリケーションクラッシュ時の例外コードとして頻出する。
WinDbgの!error: Win32・Winsock・NTSTATUS・NetAPIのエラー値をデコードして表示するWinDbgの拡張コマンド。フラグに1を指定するとNTSTATUSとして解釈する。
HRESULTから.NET例外へのマップ: COM相互運用でHRESULTの失敗を受け取った.NETランタイムが、既知の値は対応する例外型に、未知の値はCOMExceptionに変換する仕組み。元の値はException.HResultに残る。
最終エラーコード(GetLastError): スレッドごとに保持される直近のエラーコード。失敗を確認した直後にGetLastErrorで取得する。

機械可読データ

JSON-LD / Turtle ── この記事の知識グラフ全体
概念一覧 / 語彙(述語)の定義

このデータセットについて

作成: 合同会社小村ソフト
ライセンス: CC BY 4.0 ── 出典(合同会社小村ソフト)とライセンスへのリンクを明示し、改変した場合はその旨を示すことを条件に、再配布・改変を含めて再利用できます
最終確認日: 2026-08-22 ── 収録する関係のうち、最後に出典と照合した日

このページはサイトの知識グラフ(_data/knowledge/)から自動生成されています。誤りの指摘はお問い合わせからお願いします。