Platform::COMException 類別

  • 發行項

代表應用程式執行期間所發生的 COM 錯誤。 COMException 是一組預先定義的標準例外狀況所適用的基底類別。

語法

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

成員

COMException 類別繼承自 Object 類別以及 IException、IPrintable 與 IEquatable 介面。

COMException 也有下列型別的成員。

建構函式

member 描述
COMException 初始化 COMException 類別的新執行個體。

方法

COMException 類別會從 Platform::Object Class繼承 Equals()、Finalize()、GetHashCode()、GetType()、MemberwiseClose() 與 ToString() 等方法。

屬性

COMException 類別具有下列屬性。

member 描述
Exception：：HResult 對應於例外狀況的 HRESULT。
Exception：：Message 說明例外狀況的訊息。

衍生的例外狀況

下列預先定義的例外狀況衍生自 COMException。 它們與 COMException 的差異，僅在於其名稱、其建構函式的名稱以及其基礎 HRESULT 值。

名稱 基礎 HRESULT 描述
COMException 使用者定義的 HRESULT 在 COM 方法呼叫傳回無法辨認的 HRESULT 時擲回。
AccessDeniedException E_ACCESSDENIED 在存取資源或功能遭拒時擲回。
ChangedStateException E_CHANGED_STATE 在父集合變更後呼叫集合 Iterator 或集合檢視的方法時擲回，藉以讓該方法的結果失效。
ClassNotRegisteredException REGDB_E_CLASSNOTREG 在 COM 類別未登錄時擲回。
DisconnectedException RPC_E_DISCONNECTED 在物件與用戶端的連接中斷時擲回。
FailureException E_FAIL 在作業失敗時擲回。
InvalidArgumentException E_INVALIDARG 當其中一個提供給方法的引數無效時擲回。
InvalidCastException E_NOINTERFACE 在類型無法轉換成另一種類型時擲回。
NotImplementedException E_NOTIMPL 在介面方法未於類別上實作時擲回。
NullReferenceException E_POINTER 在嘗試解除 Null 物件的參考時擲回。
OperationCanceledException E_ABORT 在作業中止時擲回。
OutOfBoundsException E_BOUNDS 在作業嘗試存取有效範圍以外的資料時擲回。
OutOfMemoryException E_OUTOFMEMORY 在沒有足夠的記憶體可完成作業時擲回。

需求

最低支援用戶端： Windows 8

最低支援伺服器： Windows Server 2012

命名空間： Platform

中繼資料： platform.winmd

COMException::COMException 建構函式

初始化 COMException 類別的新執行個體。

語法

COMException( int hresult )

參數

hresult
由例外狀況表示的錯誤 HRESULT。

COMException::HResult 屬性

對應於例外狀況的 HRESULT。

語法

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

屬性值

指定錯誤的 HRESULT 值。

備註

如需如何解譯 HRESULT 值的詳細資訊，請參閱 COM 錯誤碼 的結構。

COMException::Message 屬性

說明例外狀況的訊息。

語法

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

屬性值

例外狀況的描述。

另請參閱

平台命名空間