Marshal.GetLastWin32Error Methode

Definition

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Gibt den Fehlercode zurück, der durch die letzte nicht verwaltete Funktion zurückgegeben wurde, die mit einem Plattformaufruf aufgerufen wurde und bei der das SetLastError-Flag festgelegt wurde.

public:
 static int GetLastWin32Error();

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

public static int GetLastWin32Error ();

[<System.Security.SecurityCritical>]
static member GetLastWin32Error : unit -> int

static member GetLastWin32Error : unit -> int

Public Shared Function GetLastWin32Error () As Integer

Gibt zurück

Int32

Der letzte durch einen Aufruf der Win32-SetLastError-Funktion festgelegte Fehlercode.

Attribute

SecurityCriticalAttribute

Beispiele

Im folgenden Beispiel wird die GetLastWin32Error Methode aufgerufen. Im Beispiel wird zuerst das Aufrufen der Methode ohne Fehler veranschaulicht und dann das Aufrufen der Methode mit einem Fehler veranschaulicht.

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

Imports System.Runtime.InteropServices

Module 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)> _
    Function MessageBox(ByVal hwnd As IntPtr, ByVal text As String, ByVal caption As String, ByVal type As UInt32) As Integer
    End Function

End Module

Module Program


    Sub 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.
        Dim errorVal As Integer

        errorVal = Marshal.GetLastWin32Error()

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

        ' 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.

        errorVal = Marshal.GetLastWin32Error()

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

    End Sub

    Sub Main(ByVal args() As String)

        Run()

    End Sub

End Module

' 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

Hinweise

Auf Windows-Systemen GetLastWin32Error wird die Win32 GetLastError-Funktion aus Kernel32.DLL verfügbar gemacht. Diese Methode ist vorhanden, da sie nicht zuverlässig ist, um einen direkten Aufruf der Plattform zu erstellen, um GetLastError diese Informationen abzurufen. Wenn Sie auf diesen Fehlercode zugreifen möchten, müssen GetLastWin32Error Sie stattdessen ihre eigene Plattformaufrufdefinition für GetLastError und aufrufen. Die allgemeine Sprachlaufzeit kann interne Aufrufe an APIs vornehmen, die den GetLastError vom Betriebssystem verwalteten Betrieb überschreiben.

Sie können diese Methode verwenden, um Fehlercodes nur abzurufen, wenn Sie die System.Runtime.InteropServices.DllImportAttribute Methodensignatur anwenden und das DllImportAttribute.SetLastError Feld trueauf festlegen. Der Prozess für dies variiert je nach verwendeter Quellsprache: C# und C++ sind false standardmäßig, aber die Declare Anweisung in Visual Basic ist true.

Es gibt einen Unterschied im Verhalten der GetLastWin32Error Methode auf .NET Core und .NET Framework, wenn DllImportAttribute.SetLastError truedies ist. Auf .NET Framework kann die GetLastWin32Error Methode Fehlerinformationen aus einem P/Invoke-Aufruf zum nächsten beibehalten. Bei .NET Core werden Fehlerinformationen vor dem Aufruf von P/Invoke gelöscht und stellen GetLastWin32Error nur Fehlerinformationen aus dem letzten Methodenaufruf dar.

In .NET 6- und höher-Versionen entspricht diese Methode funktionell , die benannt wird GetLastPInvokeError, um die Absicht der API und deren plattformübergreifender Art besser widerzuspiegeln. GetLastPInvokeError sollte vorgezogen GetLastWin32Errorwerden.

Siehe auch

• DllImportAttribute