Menggunakan Makro untuk Penanganan Kesalahan
COM mendefinisikan sejumlah makro yang memudahkan untuk bekerja dengan nilai HRESULT.
Makro penanganan kesalahan dijelaskan dalam tabel berikut.
| Makro | Deskripsi |
|---|---|
|
MAKE_HRESULT |
Mengembalikan HRESULT dengan bit tingkat keparahan, kode fasilitas, dan kode kesalahan yang terdiri dari HRESULT. Catatan: MAKE_HRESULT Panggilan untuk verifikasi S_OK membawa penalti performa. Anda tidak boleh secara rutin menggunakan MAKE_HRESULT untuk hasil yang berhasil. |
|
MAKE_SCODE |
Mengembalikan SCODE berdasarkan bit tingkat keparahan, kode fasilitas, dan kode kesalahan yang terdiri dari SCODE. |
|
HRESULT_CODE |
Mengekstrak bagian kode kesalahan dari HRESULT . |
|
HRESULT_FACILITY |
Mengambil kode fasilitas dari HRESULT . |
|
HRESULT_SEVERITY |
Mengekstrak bit tingkat keparahan HRESULT. |
|
SCODE_CODE |
Mengekstrak bagian kode kesalahan SCODE. |
|
SCODE_FACILITY |
Mengekstrak kode fasilitas SCODE. |
|
SCODE_SEVERITY |
Mengekstrak bidang tingkat keparahan SCODE. |
|
BERHASIL |
Menguji bit tingkat keparahan SCODE atau HRESULT; mengembalikan TRUE jika tingkat keparahannya nol dan FALSE jika tingkat keparahannya satu. |
|
GAGAL |
Menguji bit tingkat keparahan SCODE atau HRESULT; mengembalikan TRUE jika tingkat keparahannya adalah satu dan FALSE jika nol. |
|
IS_ERROR |
Menyediakan pengujian generik untuk kesalahan pada nilai status apa pun. |
|
HRESULT_FROM_WIN32 |
Menerjemahkan kode kesalahan sistem ke dalam nilai HRESULT . |
|
HRESULT_FROM_NT |
Memetakan nilai status NT ke nilai HRESULT . |
Topik terkait
-
Penanganan Kesalahan di COM