Marshal.GetLastWin32Error Methode

Definition

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

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

Attribute

Beispiele

Im folgenden Beispiel wird die GetLastWin32Error -Methode aufgerufen. Das Beispiel veranschaulicht zunächst das Aufrufen der Methode ohne Fehler und dann das Aufrufen der Methode mit einem vorhandenen Fehler.

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

Macht auf Windows-Systemen GetLastWin32Error die Win32 GetLastError-Funktion von Kernel32.DLL verfügbar. Diese Methode ist vorhanden, da es nicht zuverlässig ist, einen direkten Plattformaufruf zu tätigen, um GetLastError diese Informationen abzurufen. Wenn Sie auf diesen Fehlercode zugreifen möchten, müssen Sie aufrufen GetLastWin32Error , anstatt eine eigene Plattformaufrufdefinition für GetLastError zu schreiben und sie aufzurufen. Die Common Language Runtime kann interne Aufrufe von APIs tätigen, die die GetLastError vom Betriebssystem verwalteten überschreiben.

Sie können diese Methode nur verwenden, um Fehlercodes abzurufen, wenn Sie die System.Runtime.InteropServices.DllImportAttribute auf die Methodensignatur anwenden und das DllImportAttribute.SetLastError Feld auf truefestlegen. Der Prozess hierfür 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 in .NET Core und .NET Framework, wenn DllImportAttribute.SetLastError ist true. Unter .NET Framework kann die GetLastWin32Error -Methode Fehlerinformationen von einem P/Invoke-Aufruf an den nächsten speichern. In .NET Core werden Fehlerinformationen vor dem P/Invoke-Aufruf gelöscht, und die GetLastWin32Error stellt nur Fehlerinformationen aus dem letzten Methodenaufruf dar.

In .NET 6 und höheren Versionen ist diese Methode funktionell gleichwertig mit GetLastPInvokeError, die benannt ist, um die Absicht der API und ihre plattformübergreifende Natur besser widerzuspiegeln. GetLastPInvokeError sollte gegenüber GetLastWin32Errorbevorzugt werden.

Gilt für:

Weitere Informationen