Platform::COMException Class
Mewakili kesalahan COM yang terjadi selama eksekusi aplikasi. COMException adalah kelas dasar untuk serangkaian pengecualian standar yang telah ditentukan sebelumnya.
Sintaks
public ref class COMException : Exception, IException, IPrintable, IEquatable
Anggota
Kelas COMException mewarisi dari kelas Object dan antarmuka IException, IPrintable, dan IEquatable.
COMException juga memiliki jenis anggota berikut.
Konstruktor
| Anggota | Deskripsi |
|---|---|
| COMException | Menginisialisasi instans baru kelas COMException. |
Metode
Kelas COMException mewarisi metode Equals(), Finalize(), GetHashCode(), GetType(), MemberwiseClose(), dan ToString() dari Platform::Object Class.
Properti
Kelas COMException memiliki properti berikut.
| Anggota | Deskripsi |
|---|---|
| Pengecualian::HResult | HRESULT yang sesuai dengan pengecualian. |
| Pengecualian::Pesan | Pesan yang menjelaskan pengecualian. |
Pengecualian Turunan
Pengecualian yang telah ditentukan sebelumnya berikut berasal dari COMException. Mereka berbeda dari COMException hanya atas namanya, nama konstruktor mereka, dan nilai HRESULT yang mendasar.
| Nama | HRESULT yang mendasar | Deskripsi |
|---|---|---|
| COMException | hresult yang ditentukan pengguna | Dilemparkan ketika HRESULT yang tidak dikenal dikembalikan dari panggilan metode COM. |
| AccessDeniedException | E_ACCESSDENIED | Dilemparkan saat akses ditolak ke sumber daya atau fitur. |
| ChangedStateException | E_CHANGED_STATE | Dilemparkan ketika metode iterator koleksi atau tampilan koleksi dipanggil setelah koleksi induk berubah, membatalkan hasil metode. |
| ClassNotRegisteredException | REGDB_E_CLASSNOTREG | Dilemparkan ketika kelas COM belum terdaftar. |
| DisconnectedException | RPC_E_DISCONNECTED | Dilemparkan ketika objek terputus dari kliennya. |
| FailureException | E_FAIL | Dilemparkan ketika operasi gagal. |
| InvalidArgumentException | E_INVALIDARG | Dilemparkan ketika salah satu argumen yang diberikan ke metode tidak valid. |
| InvalidCastException | E_NOINTERFACE | Dilemparkan ketika jenis tidak dapat dilemparkan ke jenis lain. |
| NotImplementedException | E_NOTIMPL | Dilemparkan jika metode antarmuka belum diimplementasikan pada kelas. |
| NullReferenceException | E_POINTER | Dilemparkan ketika ada upaya untuk mendereferensikan referensi objek null. |
| OperationCanceledException | E_ABORT | Dilemparkan ketika operasi dibatalkan. |
| OutOfBoundsException | E_BOUNDS | Dilemparkan ketika operasi mencoba mengakses data di luar rentang yang valid. |
| OutOfMemoryException | E_OUTOFMEMORY | Dilemparkan ketika tidak ada cukup memori untuk menyelesaikan operasi. |
Persyaratan
Klien minimum yang didukung: Windows 8
Server minimum yang didukung: Windows Server 2012
Namespace: Platform
Metadata: platform.winmd
COMException::COMException Constructor
Mengintialisasi instans baru kelas COMException.
Sintaks
COMException(int hresult);
Parameter
hresult
Kesalahan HRESULT yang diwakili oleh pengecualian.
COMException::HResult Property
HRESULT yang sesuai dengan pengecualian.
Sintaks
public:
property int HResult { int get(); }
Nilai Properti
Nilai HRESULT yang menentukan kesalahan.
Keterangan
Untuk informasi selengkapnya tentang cara menginterpretasikan nilai HRESULT, lihat Struktur Kode Kesalahan COM.
COMException::Message Property
Pesan yang menjelaskan pengecualian.
Sintaks
public:
property String^ Message { String^ get(); }
Nilai Properti
Deskripsi pengecualian.