COMCapeOpenExceptionWrapper Class

[SerializableAttribute]
[ComVisibleAttribute(true)]
[ClassInterfaceAttribute(ClassInterfaceType.None)]
[GuidAttribute("31CD55DE-AEFD-44ff-8BAB-F6252DD43F16")]
public class COMCapeOpenExceptionWrapper : CapeUserException

<SerializableAttribute>
<ComVisibleAttribute(true)>
<ClassInterfaceAttribute(ClassInterfaceType.None)>
<GuidAttribute("31CD55DE-AEFD-44ff-8BAB-F6252DD43F16")>
Public Class COMCapeOpenExceptionWrapper
	Inherits CapeUserException

Inheritance

Object    Exception    ApplicationException    CapeUserException    COMCapeOpenExceptionWrapper

This class can be used when a COM-based CAPE-OPEN component returns a failure HRESULT. A failure HRESULT indicates an error condition has occurred. This class is used by the to rethrow the COM-based error condition as a .Net-based exception.

The CAPE-OPEN error handling process chose not to use the COM IErrorInfo API due to limitation of the Visual Basic programming language at the time that the error handling protocols were developed. Instead, the CAPE-OPEN error handling protocol requires that component in which the error occurs expose the appropriate error interfaces. In practice, this typically means that all CAPE-OPEN objects implement the , , and sometimes the error interfaces.

This class wraps the CAPE-OPEN object that threw the exception and creates the appropriate .Net exception so users can use the .Net exception handling protocols.

Reference