Kelas CHandle
Kelas ini menyediakan metode untuk membuat dan menggunakan objek handel.
Sintaks
class CHandle
Anggota
Konstruktor Publik
| Nama | Deskripsi |
|---|---|
| CHandle::CHandle | Konstruktor. |
| CHandle::~CHandle | Destruktor. |
Metode Publik
| Nama | Deskripsi |
|---|---|
| CHandle::Lampirkan | Panggil metode ini untuk melampirkan objek ke CHandle handel yang ada. |
| CHandle::Close | Panggil metode ini untuk menutup CHandle objek. |
| CHandle::D etach | Panggil metode ini untuk melepaskan handel dari CHandle objek. |
Operator Publik
| Nama | Deskripsi |
|---|---|
| CHandle::operator HANDLE | Mengembalikan nilai handel tersimpan. |
| CHandle::operator = | Operator penugasan. |
Anggota Data Publik
| Nama | Deskripsi |
|---|---|
| CHandle::m_h | Variabel anggota yang menyimpan handel. |
Keterangan
Objek CHandle dapat digunakan setiap kali handel diperlukan: perbedaan utamanya adalah objek CHandle akan dihapus secara otomatis.
Catatan
Beberapa fungsi API akan menggunakan NULL sebagai handel kosong atau tidak valid, sementara yang lain menggunakan INVALID_HANDLE_VALUE. CHandle hanya menggunakan NULL dan akan memperlakukan INVALID_HANDLE_VALUE sebagai handel nyata. Jika Anda memanggil API yang dapat mengembalikan INVALID_HANDLE_VALUE, Anda harus memeriksa nilai ini sebelum memanggil CHandle::Lampirkan atau meneruskannya ke CHandle konstruktor, dan sebaliknya meneruskan NULL.
Persyaratan
Header: atlbase.h
CHandle::Lampirkan
Panggil metode ini untuk melampirkan objek ke CHandle handel yang ada.
void Attach(HANDLE h) throw();
Parameter
h
CHandle akan mengambil kepemilikan handel h.
Keterangan
CHandle Menetapkan objek ke handel h lalu memanggil h.Detach(). Dalam build debug, ATLASSERT akan dinaikkan jika h adalah NULL. Tidak ada pemeriksaan lain tentang validitas handel yang dibuat.
CHandle::CHandle
Konstruktor.
CHandle() throw();
CHandle(CHandle& h) throw();
explicit CHandle(HANDLE h) throw();
Parameter
h
Handel atau CHandle.
Keterangan
Membuat objek baru CHandle , secara opsional menggunakan handel atau CHandle objek yang sudah ada.
CHandle::~CHandle
Destruktor.
~CHandle() throw();
Keterangan
CHandle Membebaskan objek dengan memanggil CHandle::Close.
CHandle::Close
Panggil metode ini untuk menutup CHandle objek.
void Close() throw();
Keterangan
Menutup handel objek terbuka. Jika handel adalah NULL, yang akan menjadi kasus jika Close telah dipanggil, ATLASSERT akan dinaikkan dalam build debug.
CHandle::D etach
Panggil metode ini untuk melepaskan handel dari CHandle objek.
HANDLE Detach() throw();
Tampilkan Nilai
Mengembalikan handel yang dilepaskan.
Keterangan
Melepaskan kepemilikan handel.
CHandle::m_h
Variabel anggota yang menyimpan handel.
HANDLE m_h;
CHandle::operator =
Operator penugasan.
CHandle& operator=(CHandle& h) throw();
Parameter
h
CHandle akan mengambil kepemilikan handel h.
Tampilkan Nilai
Mengembalikan referensi ke objek baru CHandle .
Keterangan
CHandle Jika objek saat ini berisi handel, objek akan ditutup. Objek CHandle yang diteruskan akan memiliki referensi handel yang diatur ke NULL. Ini memastikan bahwa dua CHandle objek tidak akan pernah berisi handel aktif yang sama.
CHandle::operator HANDLE
Mengembalikan nilai handel tersimpan.
operator HANDLE() const throw();
Keterangan
Mengembalikan nilai yang disimpan di CHandle::m_h.