IObjectControl::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 IObjectControl 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 IObjectControl.
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 IObjectControl 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 dan didaur 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 IObjectControl sebelum memanggil metode Aktifkan (ketika berada di konstruktornya). Panggilan seperti itu akan mengakibatkan kesalahan RPC_E_DISCONNECTED. Misalnya, jika objek mengeluarkan referensi ke dirinya sendiri saat berada di konstruktornya dan kemudian referensi memanggil kembali ke objek tersebut sebelum panggilan ke Aktifkan, kesalahan terputus dikembalikan.
Anda juga dapat menggunakan metode Aktifkan untuk mendapatkan referensi ke antarmuka ISecurityProperty objek dan memeriksa ID keamanan pembuat objek sebelum metode apa pun dipanggil.
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 |