Kelas CComUnkArray

Kelas ini menyimpan IUnknown pointer, dan dirancang untuk digunakan sebagai parameter ke kelas templat IConnectionPointImpl .

Sintaks

template<unsigned int nMaxSize>
class CComUnkArray

Parameter

nMaxSize
Jumlah IUnknown maksimum pointer yang dapat ditahan dalam array statis.

Anggota

Konstruktor Publik

Nama	Deskripsi
CComUnkArray::CComUnkArray	Konstruktor.

Metode Publik

Nama	Deskripsi
CComUnkArray::Add	Panggil metode ini untuk menambahkan penunjuk IUnknown ke array.
CComUnkArray::begin	Mengembalikan penunjuk ke penunjuk pertama IUnknown dalam koleksi.
CComUnkArray::end	Mengembalikan penunjuk ke satu melewati penunjuk terakhir IUnknown dalam koleksi.
CComUnkArray::GetCookie	Panggil metode ini untuk mendapatkan cookie yang terkait dengan pointer tertentu IUnknown .
CComUnkArray::GetUnknown	Panggil metode ini untuk mendapatkan pointer yang IUnknown terkait dengan cookie tertentu.
CComUnkArray::Remove	Panggil metode ini untuk menghapus IUnknown penunjuk dari array.

Keterangan

CComUnkArray menyimpan jumlah IUnknown pointer tetap, setiap antarmuka pada titik koneksi. CComUnkArray dapat digunakan sebagai parameter ke kelas templat IConnectionPointImpl . CComUnkArray<1> adalah spesialisasi CComUnkArray templat yang telah dioptimalkan untuk satu titik koneksi.

Metode CComUnkArray dimulai dan berakhir dapat digunakan untuk mengulangi semua titik koneksi (misalnya, ketika peristiwa ditembakkan).

Lihat Menambahkan Titik Koneksi ke Objek untuk detail tentang mengotomatiskan pembuatan proksi titik koneksi.

Catatan

Catatan Kelas CComDynamicUnkArray digunakan oleh wizard Tambahkan Kelas saat membuat kontrol yang memiliki Titik Koneksi. Jika Anda ingin menentukan jumlah Titik Koneksi secara manual, ubah referensi dari CComDynamicUnkArray ke CComUnkArray< n >, di mana n adalah jumlah titik koneksi yang diperlukan.

Persyaratan

Header: atlcom.h

CComUnkArray::Add

Panggil metode ini untuk menambahkan penunjuk IUnknown ke array.

DWORD Add(IUnknown* pUnk);

Parameter

Punk
Panggil metode ini untuk menambahkan penunjuk IUnknown ke array.

Tampilkan Nilai

Mengembalikan cookie yang terkait dengan penunjuk yang baru ditambahkan, atau 0 jika array tidak cukup besar untuk berisi pointer baru.

CComUnkArray::begin

Mengembalikan penunjuk ke awal kumpulan IUnknown penunjuk antarmuka.

IUnknown**
    begin();

Tampilkan Nilai

Penunjuk ke IUnknown penunjuk antarmuka.

Keterangan

Koleksi berisi pointer ke antarmuka yang disimpan secara lokal sebagai IUnknown. Anda melemparkan setiap IUnknown antarmuka ke jenis antarmuka nyata dan kemudian memanggil melaluinya. Anda tidak perlu mengkueri antarmuka terlebih dahulu.

Sebelum menggunakan IUnknown antarmuka, Anda harus memeriksa bahwa antarmuka tersebut bukan NULL.

CComUnkArray::CComUnkArray

Konstruktor.

CComUnkArray();

Keterangan

Mengatur koleksi untuk menahan nMaxSize IUnknown penunjuk, dan menginisialisasi penunjuk ke NULL.

CComUnkArray::end

Mengembalikan penunjuk ke satu melewati penunjuk terakhir IUnknown dalam koleksi.

IUnknown**
    end();

Tampilkan Nilai

Penunjuk ke IUnknown penunjuk antarmuka.

Keterangan

Metode CComUnkArray begin dan end dapat digunakan untuk mengulang semua titik koneksi, misalnya, ketika peristiwa ditembakkan.

IUnknown** p = m_vec.begin();
while(p != m_vec.end())
{
   // Do something with *p
   p++;
}

CComUnkArray::GetCookie

Panggil metode ini untuk mendapatkan cookie yang terkait dengan pointer tertentu IUnknown .

DWORD WINAPI GetCookie(IUnknown** ppFind);

Parameter

ppFind
Penunjuk IUnknown di mana cookie terkait diperlukan.

Tampilkan Nilai

Mengembalikan cookie yang terkait dengan IUnknown penunjuk, atau 0 jika tidak ada penunjuk yang IUnknown cocok yang ditemukan.

Keterangan

Jika ada lebih dari satu instans penunjuk yang sama IUnknown , fungsi ini mengembalikan cookie untuk yang pertama.

CComUnkArray::GetUnknown

Panggil metode ini untuk mendapatkan pointer yang IUnknown terkait dengan cookie tertentu.

IUnknown* WINAPI GetUnknown(DWORD dwCookie);

Parameter

dwCookie
Cookie yang diperlukan penunjuk terkait IUnknown .

Tampilkan Nilai

Mengembalikan penunjuk IUnknown , atau NULL jika tidak ada cookie yang cocok yang ditemukan.

CComUnkArray::Remove

Panggil metode ini untuk menghapus IUnknown penunjuk dari array.

BOOL Remove(DWORD dwCookie);

Parameter

dwCookie
Cookie yang mereferensikan IUnknown penunjuk yang akan dihapus dari array.

Tampilkan Nilai

Mengembalikan TRUE jika penunjuk dihapus, FALSE jika tidak.

Lihat juga

Kelas CComDynamicUnkArray
Gambaran Umum Kelas