IUnknown::Metode AddRef (unknwn.h)

  • Artikel

Menaikkan jumlah referensi untuk penunjuk antarmuka ke objek COM. Anda harus memanggil metode ini setiap kali Anda membuat salinan penunjuk antarmuka

Sintaks

ULONG AddRef();

Mengembalikan nilai

Metode mengembalikan jumlah referensi baru. Nilai ini dimaksudkan untuk digunakan hanya untuk tujuan pengujian.

Keterangan

Objek COM menggunakan mekanisme penghitungan referensi per antarmuka untuk memastikan bahwa objek tidak melampaui referensi ke dalamnya. Anda menggunakan AddRef untuk menstabilkan salinan penunjuk antarmuka. Ini juga dapat dipanggil ketika masa pakai pointer kloning harus melampaui masa pakai pointer asli. Pointer kloning harus dirilis dengan memanggil IUnknown::Release di atasnya.

Penghitung referensi internal yang dipertahankan AddRef harus berupa bilangan bulat yang tidak ditandatangani 32-bit.

Catatan untuk pemanggil

Panggil metode ini untuk setiap salinan baru penunjuk antarmuka yang Anda buat. Misalnya, jika Anda mengembalikan salinan pointer dari metode , maka Anda harus memanggil AddRef pada pointer tersebut. Anda juga harus memanggil AddRef pada pointer sebelum meneruskannya sebagai parameter masuk ke metode; metode akan memanggil IUnknown::Release sebelum menyalin nilai keluar di atasnya.

Persyaratan

   
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header unknwn.h

Lihat juga