DllImportAttribute.SetLastError フィールド

.NET Framework クラス ライブラリ リファレンス

DllImportAttribute.SetLastError フィールド

属性付きメソッドから戻る前に、呼び出し先が SetLastError Win32 API 関数を呼び出すかどうかを示します。

名前空間: System.Runtime.InteropServices
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public SetLastError As Boolean

Visual Basic (使用法)

Dim instance As DllImportAttribute
Dim value As Boolean

value = instance.SetLastError

instance.SetLastError = value

C#

public bool SetLastError

C++

public:
bool SetLastError

J#

public boolean SetLastError

JScript

public var SetLastError : boolean

解説

呼び出し先が SetLastError を呼び出すことを示す場合は true。それ以外の場合は false。既定値は false です (Visual Basic を除く)。

ランタイム マーシャラは GetLastError を呼び出し、返された値をキャッシュに格納して、他の API 呼び出しによる上書きを防止します。GetLastWin32Error を呼び出して、エラー コードを取得できます。

使用例

場合によっては、Visual Basic の開発者は、マネージ コードで DLL 関数を定義する際、Declare ステートメントを使用する代わりに、DllImportAttribute を使用します。SetLastError フィールドの設定は、このような事例の 1 つです。

Visual Basic

Imports System.Runtime.InteropServices
 Public Class Win32
     <DllImport ("user32.dll", SetLastError :=
 False)> _
     Public Shared Function
 MessageBoxA (ByVal hWnd As Integer,
 _
         ByVal txt As String,
 ByVal caption As String,
 _
         ByVal Typ As Integer)
 As Integer
     End Function
 End Class

C#

using System.Runtime.InteropServices;
 public class Win32 {
     [DllImport("user32.dll", SetLastError=true)]
     public static extern int
 MessageBoxA(int hWnd, String text, 
                              String caption, uint type);
 }

C++

using namespace System::Runtime::InteropServices;
 typedef void* HWND;
 [DllImport("user32", SetLastError=true)]
 extern "C" int MessageBoxA(HWND hWnd,
                           String* pText,
                           String* pCaption,
                           unsigned int uType);

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
DllImportAttribute クラス
DllImportAttribute メンバ
System.Runtime.InteropServices 名前空間
GetLastWin32Error