Marshal.GetLastWin32Error メソッド

定義

SetLastError フラグが設定され、プラットフォーム呼び出しを使用して呼び出された、最終アンマネージ関数によって返されるエラー コードを返します。

C#
[System.Security.SecurityCritical]
public static int GetLastWin32Error ();
C#
public static int GetLastWin32Error ();

戻り値

Win32 SetLastError 関数への呼び出しで最後に設定されたエラー コード。

属性

次の例では、 メソッドを GetLastWin32Error 呼び出します。 この例では、最初にエラーが存在しないメソッドの呼び出しを示し、次にエラーが存在するメソッドの呼び出しを示します。

C#
using System;
using System.Runtime.InteropServices;

internal class Win32
{
    // Use DllImportAttribute to inport the Win32 MessageBox
    // function.  Set the SetLastError flag to true to allow
    // the function to set the Win32 error.
    [DllImportAttribute("user32.dll", SetLastError = true, CharSet = CharSet.Unicode)]
    public static extern int MessageBox(IntPtr hwnd, String text, String caption, uint type);
}

class Program
{

    static void Run()
    {
        // Call the MessageBox with normal parameters.

        Console.WriteLine("Calling Win32 MessageBox without error...");

        Win32.MessageBox(new IntPtr(0), "Press OK...", "Press OK Dialog", 0);

        // Get the last error and display it.
        int error = Marshal.GetLastWin32Error();

        Console.WriteLine("The last Win32 Error was: " + error);

        // Call the MessageBox with an invalid window handle to
        // produce a Win32 error.

        Console.WriteLine("Calling Win32 MessageBox with error...");

        Win32.MessageBox(new IntPtr(123132), "Press OK...", "Press OK Dialog", 0);

        // Get the last error and display it.

        error = Marshal.GetLastWin32Error();

        Console.WriteLine("The last Win32 Error was: " + error);
    }

    static void Main(string[] args)
    {
        Run();
    }
}
// This code example displays the following to the console:
//
// Calling Win32 MessageBox without error...
// The last Win32 Error was: 0
// Calling Win32 MessageBox with error...
// The last Win32 Error was: 1400

注釈

Windows システムでは、 GetLastWin32Error Kernel32.DLL から Win32 GetLastError 関数を公開します。 このメソッドは、この情報を取得するために直接プラットフォーム呼び出しを行う信頼性がないために GetLastError 存在します。 このエラー コードにアクセスする場合は、独自のプラットフォーム呼び出し定義GetLastErrorを記述して呼び出GetLastWin32Errorす代わりに を呼び出す必要があります。 共通言語ランタイムは、オペレーティング システムによって管理される を上書き GetLastError する API に対して内部呼び出しを行うことができます。

このメソッドを使用すると、メソッド シグネチャに をSystem.Runtime.InteropServices.DllImportAttribute適用し、フィールドtrueを に設定した場合にのみエラー コードをDllImportAttribute.SetLastError取得できます。 このプロセスは、使用されるソース言語によって異なります。C# と C++ は false 既定でですが、 Declare Visual Basic の ステートメントは です true

が の場合DllImportAttribute.SetLastError、.NET Core と .NET Framework での メソッドのGetLastWin32Error動作に違いがありますtrue。 .NET Framework では、 メソッドは GetLastWin32Error 、ある P/Invoke 呼び出しから次の呼び出しまでのエラー情報を保持できます。 .NET Core では、P/Invoke 呼び出しの前にエラー情報がクリアされ GetLastWin32Error 、 は最後のメソッド呼び出しからのエラー情報のみを表します。

.NET 6 以降のバージョンでは、このメソッドは 機能的には と同等 GetLastPInvokeErrorです。これは、API の意図とそのクロスプラットフォームの性質をより適切に反映するようにという名前が付けられています。 GetLastPInvokeError より優先される GetLastWin32Error必要があります。

適用対象

製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

こちらもご覧ください