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.

Lihat juga

Gambaran Umum Kelas