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.