Penanganan Kesalahan dalam COM (COM)

  • Artikel

Hampir semua fungsi COM dan metode antarmuka mengembalikan nilai jenis HRESULT. HRESULT (nama dapat dibaca sebagai "penanganan hasil") adalah cara mengembalikan nilai keberhasilan, peringatan, atau kesalahan. HRESULT sebenarnya bukan handel (lihat Mengapa HRESULT dimulai dengan H ketika bukan handel untuk apa pun?); itu hanya nilai dengan beberapa bidang yang dikodekan ke dalamnya. Sesuai spesifikasi COM, hasil dari nol menunjukkan keberhasilan, dan hasil nonzero menunjukkan kegagalan.

Pada tingkat kode sumber, semua nilai kesalahan terdiri dari tiga bagian, dipisahkan oleh garis bawah. Bagian pertama adalah awalan yang mengidentifikasi fasilitas yang terkait dengan kesalahan, bagian kedua adalah E untuk kesalahan, dan bagian ketiga adalah string yang menjelaskan kondisi aktual. Misalnya, STG_E_MEDIUMFULL dikembalikan ketika tidak ada ruang yang tersisa di hard disk. Awalan STG menunjukkan fasilitas penyimpanan, E menunjukkan bahwa kode status mewakili kesalahan, dan MEDIUMFULL memberikan informasi spesifik tentang kesalahan. Banyak nilai yang mungkin ingin Anda kembalikan dari metode antarmuka atau fungsi didefinisikan dalam Winerror.h.

Untuk informasi selengkapnya tentang penanganan kesalahan, lihat bagian berikut ini:

Kode Kesalahan COM