Asposecpplib
System::ComponentModel::Details_Win32Exception Class Reference

Throws an exception for a Win32 error code. Never create instances of this class manually. Use the Win32Exception class instead. Never wrap the Win32Exception class instances into System::SmartPtr. More...

Inherits System::Details_ExceptionWithErrorCode< Details_SystemException >.

Public Member Functions

virtual int32_t get_NativeErrorCode () const
 Gets the Win32 error code associated with this exception. More...
 
- Public Member Functions inherited from System::Details_ExceptionWithErrorCode< Details_SystemException >
virtual int32_t get_ErrorCode () const
 Gets the HRESULT of the error. More...
 
virtual String get_Message () const override
 
- Public Member Functions inherited from System::Details_SystemException
const System::TypeInfoGetType () const override
 Gets actual type of object. Analog of C# System.Object.GetType() call. More...
 
bool Is (const System::TypeInfo &target) const override
 
- Public Member Functions inherited from System::Details_Exception
virtual String get_StackTrace () const
 Returns the string containing the stack trace. More...
 
virtual ExceptionWrapper< Details_Exceptionget_InnerException () const
 Returns a reference to the object representing the inner exception. More...
 
virtual ExceptionWrapper< Details_ExceptionGetBaseException () const
 Returns the copy of Exception object representing the inner-most exception. More...
 
int32_t get_HResult () const
 Returns a 32-bit integer value which is a HRESULT code associated with the exception reprsented by the current object. More...
 
void set_HResult (int32_t value)
 Sets HRESULT, a coded numerical value that is assigned to a specific exception. More...
 
virtual String ToString () const override
 Returns the string representation of the current object. More...
 
virtual const char * what () const noexcept
 Implements what() method which is called by ExceptionWrapper class. Despite of the fact that this class is not inherited from std::exception derived classes can use protected/private members to implement their logic. Moving this method implementation to the ExceptionWrapper may broke that logic. More...
 
- Public Member Functions inherited from System::Object
 Object ()
 Creates object. Initializes all internal data structures. More...
 
virtual ~Object ()
 Destroys object. Frees all internal data structures. More...
 
 Object (Object const &x)
 Copy constructor. Doesn't copy anything, really, just initializes new object and enables copy constructing subclasses. More...
 
Objectoperator= (Object const &x)
 Assignment operator. Doesn't copy anything, really, just initializes new object and enables copy constructing subclasses. More...
 
ObjectSharedRefAdded ()
 Increments shared reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
int SharedRefRemovedSafe ()
 Decrements and returns shared reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
int RemovedSharedRefs (int count)
 Decreases shared reference count by specified value. More...
 
Detail::SmartPtrCounter * WeakRefAdded ()
 Increments weak reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
void WeakRefRemoved ()
 Decrements weak reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
Detail::SmartPtrCounter * GetCounter ()
 Gets reference counter data structure associated with the object. More...
 
int SharedCount () const
 Gets current value of shared reference counter. More...
 
void Lock ()
 Implements C# lock() statement locking. Call directly or use LockContext sentry object. More...
 
void Unlock ()
 Implements C# lock() statement unlocking. Call directly or use LockContext sentry object. More...
 
virtual bool Equals (ptr obj)
 Compares objects using C# Object.Equals semantics. More...
 
virtual int32_t GetHashCode () const
 Analog of C# Object.GetHashCode() method. Enables hashing of custom objects. More...
 
virtual ptr MemberwiseClone () const
 Analog of C# Object.MemberwiseClone() method. Enables cloning custom types. More...
 
virtual void SetTemplateWeakPtr (uint32_t argument)
 Set n'th template argument a weak pointer (rather than shared). Allows switching pointers in containers to weak mode. More...
 
virtual bool FastCast (const Details::FastRttiBase &helper, void **out_ptr) const
 For internal purposes only. More...
 
template<>
bool ReferenceEquals (String const &str, std::nullptr_t)
 Specialization of Object::ReferenceEquals for case of string and nullptr. More...
 
template<>
bool ReferenceEquals (String const &str1, String const &str2)
 Specialization of Object::ReferenceEquals for case of strings. More...
 

Protected Member Functions

 Details_Win32Exception ()
 Initializes a new instance of the Win32Exception class with the last Win32 error that occurred. More...
 
 Details_Win32Exception (int32_t error)
 Initializes a new instance of the Win32Exception class with the specified error. More...
 
 Details_Win32Exception (const String &message)
 Initializes a new instance of the Win32Exception class with the specified detailed description. More...
 
 Details_Win32Exception (int32_t error, const String &message)
 Initializes a new instance of the Win32Exception class with the specified error and the specified detailed description. More...
 
 Details_Win32Exception (const String &message, const System::Exception &innerException)
 Initializes a new instance of the Win32Exception class with the specified detailed description and the specified exception. More...
 
void DoThrow (const System::ExceptionPtr &self) const override
 
virtual String ExtraDescription () const override
 
- Protected Member Functions inherited from System::Details_ExceptionWithErrorCode< Details_SystemException >
 Details_ExceptionWithErrorCode ()
 Initializes a new instance of the ExceptionWithErrorCode class with default properties. More...
 
 Details_ExceptionWithErrorCode (const String &message)
 Initializes a new instance of the ExceptionWithErrorCode class with a specified error message. More...
 
 Details_ExceptionWithErrorCode (const String &message, const System::Exception &innerException)
 Initializes a new instance of the ExceptionWithErrorCode class with a specified error message and a reference to the inner exception that is the cause of this exception. More...
 
 Details_ExceptionWithErrorCode (const String &message, int32_t errorCode)
 Initializes a new instance of the ExceptionWithErrorCode class with a specified error message and the HRESULT of the error. param message he error message that specifies the reason for the exception. param The HRESULT of the error. More...
 
- Protected Member Functions inherited from System::Details_SystemException
 Details_SystemException ()
 
 Details_SystemException (const System::String &message)
 
 Details_SystemException (const System::String &message, const System::ExceptionWrapper< System::Details_Exception > &innerException)
 
 Details_SystemException (const System::SharedPtr< System::Runtime::Serialization::SerializationInfo > &info, System::Runtime::Serialization::StreamingContext context)
 
void DoThrow (const System::ExceptionPtr &self) const override
 Throws exception instance wrapped by exception wrapper. More...
 
- Protected Member Functions inherited from System::Details_Exception
 Details_Exception ()
 Constructs an instance of Exception class. More...
 
 Details_Exception (const String &message)
 Constructs an instance of Exception class and assigns the specified error message to it. More...
 
 Details_Exception (const String &message, const ExceptionWrapper< Details_Exception > &innerException)
 Constructs an instance of Exception class and assigns the specified error message and a reference to the inner exception object. More...
 
 Details_Exception (const System::SharedPtr< System::Runtime::Serialization::SerializationInfo > &info, System::Runtime::Serialization::StreamingContext context)
 Deserializes exception. More...
 
String DefaultMessage () const
 Returns a default description of the exception based on type. More...
 

Additional Inherited Members

- Public Types inherited from System::Object
typedef SmartPtr< Objectptr
 Alias for smart pointer type. More...
 
- Static Public Member Functions inherited from System::Details_SystemException
static const System::TypeInfoType ()
 
- Static Public Member Functions inherited from System::Object
static bool ReferenceEquals (ptr const &objA, ptr const &objB)
 Compares objects by reference. More...
 
template<typename T >
static std::enable_if<!IsSmartPtr< T >::value, bool >::type ReferenceEquals (T const &objA, T const &objB)
 Compares objects by reference. More...
 
template<typename T >
static std::enable_if<!IsSmartPtr< T >::value, bool >::type ReferenceEquals (T const &objA, std::nullptr_t)
 Reference-compares value type object with nullptr. More...
 
template<typename T1 , typename T2 >
static std::enable_if< IsSmartPtr< T1 >::value &&IsSmartPtr< T2 >::value, bool >::type Equals (T1 const &objA, T2 const &objB)
 Compares reference type objects in C# style. More...
 
template<typename T1 , typename T2 >
static std::enable_if<!IsSmartPtr< T1 >::value &&!IsSmartPtr< T2 >::value, bool >::type Equals (T1 const &objA, T2 const &objB)
 Compares value type objects in C# style. More...
 
static const TypeInfoType ()
 Implements C# typeof(System.Object) construct. More...
 
template<>
bool Equals (float const &objA, float const &objB)
 Emulates C#-style floating point comparison where two NaNs are considered equal even though according to IEC 60559:1989 NaN is not equal to any value, including NaN. More...
 
template<>
bool Equals (double const &objA, double const &objB)
 Emulates C#-style floating point comparison where two NaNs are considered equal even though according to IEC 60559:1989 NaN is not equal to any value, including NaN. More...
 
- Protected Types inherited from System::Details_SystemException
using BaseType = System::Details_Exception
 
- Protected Attributes inherited from System::Details_Exception
String m_message
 The error description. More...
 
System::ExceptionWrapper< Details_Exceptionm_innerexception
 The Exception object representing the inner exception. More...
 
std::string m_std_message
 A string describing the std::exception portion of the current object. More...
 
int32_t m_HResult
 HRESULT code associated with the exception represented by the current object. More...
 

Detailed Description

Throws an exception for a Win32 error code. Never create instances of this class manually. Use the Win32Exception class instead. Never wrap the Win32Exception class instances into System::SmartPtr.

Constructor & Destructor Documentation

◆ Details_Win32Exception() [1/5]

System::ComponentModel::Details_Win32Exception::Details_Win32Exception ( )
protected

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

◆ Details_Win32Exception() [2/5]

System::ComponentModel::Details_Win32Exception::Details_Win32Exception ( int32_t  error)
protected

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

Parameters
errorThe Win32 error code associated with this exception.

◆ Details_Win32Exception() [3/5]

System::ComponentModel::Details_Win32Exception::Details_Win32Exception ( const String message)
protected

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

Parameters
messageA detailed description of the error.

◆ Details_Win32Exception() [4/5]

System::ComponentModel::Details_Win32Exception::Details_Win32Exception ( int32_t  error,
const String message 
)
protected

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

Parameters
errorThe Win32 error code associated with this exception.
messageA detailed description of the error.

◆ Details_Win32Exception() [5/5]

System::ComponentModel::Details_Win32Exception::Details_Win32Exception ( const String message,
const System::Exception innerException 
)
protected

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

Parameters
messageA detailed description of the error.
innerExceptionA reference to the inner exception that is the cause of this exception.

Member Function Documentation

◆ DoThrow()

void System::ComponentModel::Details_Win32Exception::DoThrow ( const System::ExceptionPtr self) const
overrideprotectedvirtual
See also
Exception::DoThrow

Reimplemented from System::Details_Exception.

◆ ExtraDescription()

virtual String System::ComponentModel::Details_Win32Exception::ExtraDescription ( ) const
overrideprotectedvirtual
See also
System::Exception::ExtraDescription

Reimplemented from System::Details_ExceptionWithErrorCode< Details_SystemException >.

◆ get_NativeErrorCode()

virtual int32_t System::ComponentModel::Details_Win32Exception::get_NativeErrorCode ( ) const
virtual

Gets the Win32 error code associated with this exception.