SetLastError 関数 (errhandlingapi.h)

呼び出し元スレッドの最終エラー コードを設定します。

構文

void SetLastError(
  [in] DWORD dwErrCode
);

パラメーター

[in] dwErrCode

スレッドの最後のエラー コード。

戻り値

なし

解説

最後のエラー コードは、複数のスレッドが互いの値を上書きしないように、スレッド ローカル ストレージに保持されます。

ほとんどの関数は、失敗した場合にのみ SetLastError または SetLastErrorEx を 呼び出します。 ただし、一部のシステム関数では、成功した条件下で SetLastError または SetLastErrorEx が呼び出されます。これらのケースは、各関数のドキュメントに記載されています。

アプリケーションは、必要に応じて、関数が失敗した直後に GetLastError 関数を使用して、この関数によって設定された値を取得できます。

エラー コードは 32 ビット値です (ビット 31 が最上位ビットです)。 ビット 29 はアプリケーション定義のエラー コード用として予約されています。このビットを設定できるシステム エラー コードはありません。 アプリケーションのエラー コードを定義する場合は、このビットを設定して、エラー コードがアプリケーションによって定義されていることを示し、エラー コードがシステム定義のエラー コードと競合しないようにします。

要件

要件	値
サポートされている最小のクライアント	Windows XP [デスクトップ アプリ | UWP アプリ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップ アプリのみ | UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	errhandlingapi.h (Windows.h を含む)
Library	Kernel32.lib
[DLL]	Kernel32.dll

関連項目

エラー処理関数

GetLastError

最終エラー コード

SetLastErrorEx

VBS エンクレーブで使用できる Vertdll API