呼び出し元スレッドの最終エラー コードを設定します。
構文
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 |