Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. |
Übersetzung
Original
|
Marshal.GetLastWin32Error-Methode
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 DllImportAttribute.SetLastError-Flag festgelegt wurde.
Assembly: mscorlib (in mscorlib.dll)
Rückgabewert
Typ: System.Int32Der letzte durch einen Aufruf der Win32-SetLastError-Funktion festgelegte Fehlercode.
GetLastWin32Error macht die Win32 GetLastError-Funktion aus Kernel32.DLL verfügbar. Diese Methode ist vorhanden, weil ein direkter Plattformaufruf von GetLastError nicht sicher ausgeführt werden kann, um diese Information abzurufen. Wenn Sie auf diesen Fehlercode zugreifen möchten, müssen Sie GetLastWin32Error aufrufen, anstatt eine eigene Plattformaufrufdefinition für GetLastError zu schreiben und aufzurufen. Die Common Language Runtime kann interne Aufrufe von APIs ausführen, die das vom Betriebssystem verwaltete GetLastError überschreiben.
Sie können mit dieser Methode nur dann Fehlercodes abrufen, wenn System.Runtime.InteropServices.DllImportAttribute auf die Methodensignatur angewendet und das SetLastError-Feld auf true festgelegt wird. Die Verarbeitung hierfür variiert in Abhängigkeit von der verwendeten Quellsprache: C# und C++ sind in der Standardeinstellung false, die Declare-Anweisung in Visual Basic ist jedoch true.
Im folgenden Beispiel wird das Aufrufen der GetLastWin32Error-Methode veranschaulicht. Das Codebeispiel veranschaulicht zunächst den Aufruf der Methode, wenn kein Fehler aufgetreten ist, und anschließend den Aufruf der Methode, wenn ein Fehler aufgetreten ist.
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
-
SecurityCriticalAttribute
Erfordert volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von teilweise vertrauenswürdigem oder transparentem Code nicht verwendet werden.
Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
