ObjectControl::Mengaktifkan metode (comsvcs.h)
Memungkinkan objek COM+ untuk melakukan inisialisasi khusus konteks setiap kali diaktifkan.
Metode ini dipanggil oleh lingkungan run-time COM+ sebelum metode lain dipanggil pada objek .
Sintaks
HRESULT Activate();
Mengembalikan nilai
Metode ini dapat mengembalikan nilai pengembalian standar E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL, dan S_OK.
Keterangan
Setiap kali klien memanggil objek COM+ yang belum aktif, lingkungan run-time COM+ secara otomatis mengaktifkan objek. Ini disebut Aktivasi Just-in-Time. Untuk komponen yang mendukung ObjectControl sebagai antarmuka, COM+ memanggil metode Aktifkan objek sebelum meneruskan panggilan metode klien ke objek.
Prosedur inisialisasi khusus konteks apa pun harus diterapkan dalam metode Aktifkan untuk objek yang mengekspos ObjectControl.
Misalnya, Anda dapat menggunakan metode Aktifkan untuk mendapatkan referensi ke konteks objek dan menyimpannya dalam variabel anggota. Kemudian konteks objek tersedia untuk metode apa pun yang memerlukannya, dan Anda tidak perlu memperoleh yang baru setiap kali Anda ingin menggunakannya. Setelah Anda memiliki referensi ke konteks objek, Anda dapat menggunakan metode ObjectContext untuk memeriksa apakah keamanan diaktifkan, apakah objek dijalankan dalam transaksi, atau apakah pemanggil berada dalam peran tertentu.
Jika Anda mengaktifkan daur ulang objek (dengan menerapkan metode CanBePooled untuk mengkueri objek), metode Aktifkan harus dapat menangani objek yang baru dibuat serta objek daur ulang. Ketika metode Aktifkan kembali, seharusnya tidak ada perbedaan yang dapat dibedakan antara objek baru dan yang didaur ulang.
COM+ secara tegas melarang panggilan ke objek yang mengekspos ObjectControl sebelum memanggil metode Aktifkan (ketika berada di konstruktornya). Panggilan seperti itu akan mengakibatkan kesalahan RPC_E_DISCONNECTED. Misalnya, jika objek meneruskan referensi ke dirinya sendiri saat berada di konstruktornya dan kemudian referensi memanggil kembali ke objek tersebut sebelum panggilan ke Aktifkan, kesalahan terputus dikembalikan.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | comsvcs.h |