Kelas CComGITPtr

Kelas ini menyediakan metode untuk menangani penunjuk antarmuka dan tabel antarmuka global (GIT).

Sintaks

template <class T>
class CComGITPtr

Parameter

T
Jenis penunjuk antarmuka yang akan disimpan di GIT.

Anggota

Konstruktor Publik

Nama	Deskripsi
CComGITPtr::CComGITPtr	Konstruktor.
CComGITPtr::~CComGITPtr	Destruktor.

Metode Publik

Nama	Deskripsi
CComGITPtr::Lampirkan	Panggil metode ini untuk mendaftarkan penunjuk antarmuka di tabel antarmuka global (GIT).
CComGITPtr::CopyTo	Panggil metode ini untuk menyalin antarmuka dari tabel antarmuka global (GIT) ke pointer yang diteruskan.
CComGITPtr::D etach	Panggil metode ini untuk memisahkan antarmuka dari CComGITPtr objek.
CComGITPtr::GetCookie	Panggil metode ini untuk mengembalikan cookie dari CComGITPtr objek.
CComGITPtr::Cabut	Panggil metode ini untuk menghapus antarmuka dari tabel antarmuka global (GIT).

Operator Publik

Nama	Deskripsi
CComGITPtr::operator DWORD	Mengembalikan cookie dari CComGITPtr objek.
CComGITPtr::operator =	Operator penugasan.

Anggota Data Publik

Nama	Deskripsi
CComGITPtr::m_dwCookie	Kuenya.

Keterangan

Objek yang menggabungkan marshaler utas gratis dan perlu menggunakan penunjuk antarmuka yang diperoleh dari objek lain harus mengambil langkah tambahan untuk memastikan bahwa antarmuka dinamai dengan benar. Biasanya ini melibatkan penyimpanan pointer antarmuka di GIT dan mendapatkan pointer dari GIT setiap kali digunakan. CComGITPtr Kelas ini disediakan untuk membantu Anda menggunakan pointer antarmuka yang disimpan di GIT.

Catatan

Fasilitas tabel antarmuka global hanya tersedia di Windows 95 dengan DCOM versi 1.1 dan yang lebih baru, Windows 98, Windows NT 4.0 dengan Paket Layanan 3 dan yang lebih baru, dan Windows 2000.

Persyaratan

Header: atlbase.h

CComGITPtr::Lampirkan

Panggil metode ini untuk mendaftarkan penunjuk antarmuka di tabel antarmuka global (GIT).

HRESULT Attach(T* p) throw();

HRESULT Attach(DWORD dwCookie) throw();

Parameter

p
Penunjuk antarmuka yang akan ditambahkan ke GIT.

dwCookie
Cookie yang digunakan untuk mengidentifikasi penunjuk antarmuka.

Tampilkan Nilai

Mengembalikan S_OK saat berhasil, atau kesalahan HRESULT saat gagal.

Keterangan

Dalam build debug, kesalahan pernyataan akan terjadi jika GIT tidak valid, atau jika cookie sama dengan NULL.

CComGITPtr::CComGITPtr

Konstruktor.

CComGITPtr() throw();
CComGITPtr(T* p);
CComGITPtr(const CComGITPtr& git);
explicit CComGITPtr(DWORD dwCookie) throw();
CComGITPtr(CComGITPtr&& rv);

Parameter

p
[di] Penunjuk antarmuka yang akan disimpan dalam tabel antarmuka global (GIT).

git
[di] Referensi ke objek yang sudah ada CComGITPtr .

dwCookie
[di] Cookie yang digunakan untuk mengidentifikasi penunjuk antarmuka.

Rv
[di] Objek sumber CComGITPtr untuk memindahkan data.

Keterangan

Membuat objek baru CComGITPtr , secara opsional menggunakan objek yang sudah ada CComGITPtr .

Konstruktor yang menggunakan rv adalah konstruktor pemindahan. Data dipindahkan dari sumber, rv, lalu rv dibersihkan.

CComGITPtr::~CComGITPtr

Destruktor.

~CComGITPtr() throw();

Keterangan

Menghapus antarmuka dari tabel antarmuka global (GIT), menggunakan CComGITPtr::Revoke.

CComGITPtr::CopyTo

Panggil metode ini untuk menyalin antarmuka dari tabel antarmuka global (GIT) ke pointer yang diteruskan.

HRESULT CopyTo(T** pp) const throw();

Parameter

Pp
Penunjuk yang akan menerima antarmuka.

Tampilkan Nilai

Mengembalikan S_OK saat berhasil, atau kesalahan HRESULT saat gagal.

Keterangan

Antarmuka dari GIT disalin ke penunjuk yang diteruskan. Penunjuk harus dilepaskan oleh pemanggil ketika tidak lagi diperlukan.

CComGITPtr::D etach

Panggil metode ini untuk memisahkan antarmuka dari CComGITPtr objek.

DWORD Detach() throw();

Tampilkan Nilai

Mengembalikan cookie dari CComGITPtr objek.

Keterangan

Terserah pemanggil untuk menghapus antarmuka dari GIT, menggunakan CComGITPtr::Revoke.

CComGITPtr::GetCookie

Panggil metode ini untuk mengembalikan cookie dari CComGITPtr objek.

DWORD GetCookie() const;

Tampilkan Nilai

Mengembalikan cookie.

Keterangan

Cookie adalah variabel yang digunakan untuk mengidentifikasi antarmuka dan lokasinya.

CComGITPtr::m_dwCookie

Kuenya.

DWORD m_dwCookie;

Keterangan

Cookie adalah variabel anggota yang digunakan untuk mengidentifikasi antarmuka dan lokasinya.

CComGITPtr::operator =

Operator penugasan.

CComGITPtr& operator= (T* p);
CComGITPtr& operator= (const CComGITPtr& git);
CComGITPtr& operator= (DWORD dwCookie);
CComGITPtr& operator= (CComGITPtr&& rv);

Parameter

p
[di] Penunjuk ke antarmuka.

git
[di] Referensi ke CComGITPtr objek.

dwCookie
[di] Cookie yang digunakan untuk mengidentifikasi penunjuk antarmuka.

Rv
[di] untuk CComGITPtr memindahkan data dari.

Tampilkan Nilai

Mengembalikan objek yang diperbarui CComGITPtr .

Keterangan

Menetapkan nilai baru ke CComGITPtr objek, baik dari objek yang sudah ada atau dari referensi ke tabel antarmuka global.

CComGITPtr::operator DWORD

Mengembalikan cookie yang terkait dengan CComGITPtr objek.

operator DWORD() const;

Keterangan

Cookie adalah variabel yang digunakan untuk mengidentifikasi antarmuka dan lokasinya.

CComGITPtr::Cabut

Panggil metode ini untuk menghapus antarmuka saat ini dari tabel antarmuka global (GIT).

HRESULT Revoke() throw();

Tampilkan Nilai

Mengembalikan S_OK saat berhasil, atau kesalahan HRESULT saat gagal.

Keterangan

Menghapus antarmuka dari GIT.

Baca juga

Threaded Marshaler Gratis
Mengakses Antarmuka Di Seluruh Apartemen
Kapan Menggunakan Tabel Antarmuka Global
Gambaran Umum Kelas