Win32Exception Constructors

Reference

Definition

Namespace:: System.ComponentModel

Assemblies:: Microsoft.Win32.Primitives.dll, System.dll

Assemblies:: Microsoft.Win32.Primitives.dll, netstandard.dll

Assembly:: Microsoft.Win32.Primitives.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Initializes a new instance of the Win32Exception class.

Overloads

Win32Exception()	Initializes a new instance of the Win32Exception class with the last Win32 error that occurred.
Win32Exception(Int32)	Initializes a new instance of the Win32Exception class with the specified error.
Win32Exception(String)	Initializes a new instance of the Win32Exception class with the specified detailed description.
Win32Exception(Int32, String)	Initializes a new instance of the Win32Exception class with the specified error and the specified detailed description.
Win32Exception(SerializationInfo, StreamingContext)	Obsolete. Initializes a new instance of the Win32Exception class with the specified context and the serialization information.
Win32Exception(String, Exception)	Initializes a new instance of the Win32Exception class with the specified detailed description and the specified exception.

Win32Exception()

Source:: Win32Exception.cs

Source:: Win32Exception.cs

Source:: Win32Exception.cs

Initializes a new instance of the Win32Exception class with the last Win32 error that occurred.

public:
 Win32Exception();

public Win32Exception();

Public Sub New ()

Remarks

The detailed description of the error will be determined by the Win32 error message associated with the error.

This constructor uses the GetLastWin32Error method of Marshal to get its error code.

Applies to

.NET 10 and other versions

Product	Versions
.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, 10
.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.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Win32Exception(Int32)

Source:: Win32Exception.cs

Source:: Win32Exception.cs

Source:: Win32Exception.cs

Initializes a new instance of the Win32Exception class with the specified error.

public:
 Win32Exception(int error);

public Win32Exception(int error);

new System.ComponentModel.Win32Exception : int -> System.ComponentModel.Win32Exception

Public Sub New (error As Integer)

Parameters

error: Int32

The Win32 error code associated with this exception.

Remarks

The detailed description of the error is determined by the Win32 error message associated with the error.

Applies to

.NET 10 and other versions

Product	Versions
.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, 10
.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.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Win32Exception(String)

Source:: Win32Exception.cs

Source:: Win32Exception.cs

Source:: Win32Exception.cs

Initializes a new instance of the Win32Exception class with the specified detailed description.

public:
 Win32Exception(System::String ^ message);

public Win32Exception(string message);

public Win32Exception(string? message);

new System.ComponentModel.Win32Exception : string -> System.ComponentModel.Win32Exception

Public Sub New (message As String)

Parameters

message: String

A detailed description of the error.

Applies to

.NET 10 and other versions

Product	Versions
.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, 10
.NET Framework	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.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Win32Exception(Int32, String)

Source:: Win32Exception.cs

Source:: Win32Exception.cs

Source:: Win32Exception.cs

Initializes a new instance of the Win32Exception class with the specified error and the specified detailed description.

public:
 Win32Exception(int error, System::String ^ message);

public Win32Exception(int error, string message);

public Win32Exception(int error, string? message);

new System.ComponentModel.Win32Exception : int * string -> System.ComponentModel.Win32Exception

Public Sub New (error As Integer, message As String)

Parameters

error: Int32

The Win32 error code associated with this exception.

message: String

A detailed description of the error.

Remarks

The detailed description of the error is determined by the Win32 error message associated with the error.

Applies to

.NET 10 and other versions

Product	Versions
.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, 10
.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.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Win32Exception(SerializationInfo, StreamingContext)

Source:: Win32Exception.cs

Source:: Win32Exception.cs

Source:: Win32Exception.cs

Caution

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

Initializes a new instance of the Win32Exception class with the specified context and the serialization information.

protected:
 Win32Exception(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected Win32Exception(System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

protected Win32Exception(System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.ComponentModel.Win32Exception : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.ComponentModel.Win32Exception

new System.ComponentModel.Win32Exception : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.ComponentModel.Win32Exception

Protected Sub New (info As SerializationInfo, context As StreamingContext)

Parameters

info: SerializationInfo

The SerializationInfo associated with this exception.

context: StreamingContext

A StreamingContext that represents the context of this exception.

Attributes: ObsoleteAttribute

Applies to

.NET 10 and other versions

Product	Versions (Obsolete)
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7 (8, 9, 10)
.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	2.0, 2.1

Win32Exception(String, Exception)

Source:: Win32Exception.cs

Source:: Win32Exception.cs

Source:: Win32Exception.cs

Initializes a new instance of the Win32Exception class with the specified detailed description and the specified exception.

public:
 Win32Exception(System::String ^ message, Exception ^ innerException);

public Win32Exception(string message, Exception innerException);

public Win32Exception(string? message, Exception? innerException);

new System.ComponentModel.Win32Exception : string * Exception -> System.ComponentModel.Win32Exception

Public Sub New (message As String, innerException As Exception)

Parameters

message: String

A detailed description of the error.

innerException: Exception

A reference to the inner exception that is the cause of this exception.

Applies to

.NET 10 and other versions

Product	Versions
.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, 10
.NET Framework	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.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Share via

Win32Exception Constructors

Definition

Overloads

Win32Exception()

Remarks

Applies to

Win32Exception(Int32)

Parameters

Remarks

Applies to

Win32Exception(String)

Parameters

Applies to

Win32Exception(Int32, String)

Parameters

Remarks

Applies to

Win32Exception(SerializationInfo, StreamingContext)

Parameters

Applies to

Win32Exception(String, Exception)

Parameters

Applies to

Additional resources