Marshal::GetLastWin32Error Method ()

.NET Framework (current version)

Returns the error code returned by the last unmanaged function that was called using platform invoke that has the DllImportAttribute::SetLastError flag set.

Namespace: System.Runtime.InteropServices
Assembly: mscorlib (in mscorlib.dll)

Syntax

C++

public:
[SecurityCriticalAttribute]
static int GetLastWin32Error()

Return Value

Type: System::Int32

The last error code set by a call to the Win32 SetLastError function.

GetLastWin32Error exposes the Win32 GetLastError function from Kernel32.DLL. This method exists because it is not safe to make a direct platform invoke call to GetLastError to obtain this information. If you want to access this error code, you must call GetLastWin32Error instead of writing your own platform invoke definition for GetLastError and calling it. The common language runtime can make internal calls to APIs that overwrite the GetLastError maintained by the operating system.

You can use this method to obtain error codes only if you apply the System.Runtime.InteropServices::DllImportAttribute to the method signature and set the SetLastError field totrue. The process for this varies depending upon the source language used: C# and C++ are false by default, but the Declare statement in Visual Basic is true.

Examples

The following example demonstrates calling the GetLastWin32Errormethod. The example first demonstrates calling the method with no error present and then demonstrates calling the method with an error present.

C++

No code example is currently available or this language may not be supported.

Security

SecurityCriticalAttribute

requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code.

Version Information

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1