Platform::COMException 类

  • 项目

表示在应用程序执行过程中发生的 COM 错误。 COMException 是一组预定义的标准异常的基类。

语法

public ref class COMException : Exception,    IException,    IPrintable,    IEquatable

成员

COMException 类从对象类以及 IException、IPrintable 和 IEquatable 接口继承。

COMException 还具有下列类型的成员。

构造函数

成员 说明
COMException 初始化 COMException 类的新实例。

方法

COMException 类从 Platform::Object Class继承 Equals()、Finalize(), GetHashCode()、GetType()、MemberwiseClose() 和 ToString() 方法。

属性

COMException 类具有以下属性。

成员 说明
Exception::HResult 与异常相对应的 HRESULT。
Exception::Message 描述异常的消息。

派生异常

下列预定义的异常从 COMException 派生。 它们与 COMException 的区别只在于名称、构造函数的名称和基础 HRESULT 值。

名称 基础 HRESULT 说明
COMException 用户定义的 hresult 从 COM 方法调用返回无法识别的 HRESULT 时引发。
AccessDeniedException E_ACCESSDENIED 被拒绝访问资源或功能时引发。
ChangedStateException E_CHANGED_STATE 在父集合更改后调用集合迭代器或集合视图方法，从而导致方法的结果无效时引发。
ClassNotRegisteredException REGDB_E_CLASSNOTREG 当 COM 类尚未注册时引发。
DisconnectedException RPC_E_DISCONNECTED 当对象与其客户端的连接断开时引发。
FailureException E_FAIL 操作失败时引发。
InvalidArgumentException E_INVALIDARG 当提供给方法的参数之一无效时引发。
InvalidCastException E_NOINTERFACE 当类型无法转换为另一种类型时引发。
NotImplementedException E_NOTIMPL 当接口方法尚未在类上实现时引发。
NullReferenceException E_POINTER 尝试取消引用空对象引用时引发。
OperationCanceledException E_ABORT 操作中止时引发。
OutOfBoundsException E_BOUNDS 某个操作尝试在有效范围外访问数据时引发。
OutOfMemoryException E_OUTOFMEMORY 没有足够内存来完成操作时引发。

要求

支持的最低客户端版本：Windows 8

支持的最低服务器版本：Windows Server 2012

命名空间： Platform

元数据： platform.winmd

COMException::COMException 构造函数

初始化 COMException 类的新实例。

语法

COMException( int hresult )

parameters

hresult
由异常表示的错误 HRESULT。

COMException::HResult 属性

与异常相对应的 HRESULT。

语法

public:
    property int HResult { int get();}

属性值

一个指定错误的 HRESULT 值。

注解

有关如何解释 HRESULT 值的详细信息，请参阅 COM 错误代码结构。

COMException::Message 属性

描述异常的消息。

语法

public:property String^ Message {    String^ get();}

属性值

异常的说明。

另请参阅

Platform 命名空间