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