Metode IClassFactory::LockServer (unknwnbase.h)
Mengunci aplikasi objek yang terbuka dalam memori. Ini memungkinkan instans dibuat lebih cepat.
Sintaks
HRESULT LockServer(
[in] BOOL fLock
);
Parameter
[in] fLock
Jika TRUE, menaikkan jumlah kunci; jika FALSE, mengurangi jumlah kunci.
Nilai kembali
Metode ini dapat mengembalikan nilai pengembalian standar E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL, dan S_OK.
Keterangan
IClassFactory::LockServer mengontrol apakah server objek disimpan dalam memori. Menjaga aplikasi tetap hidup dalam memori memungkinkan instans dibuat lebih cepat.
Catatan untuk Penelepon
Sebagian besar klien tidak perlu memanggil metode ini. Ini disediakan hanya untuk klien yang memerlukan performa khusus dalam membuat beberapa instans objek mereka.Catatan untuk Pelaksana
Jika jumlah kunci nol, tidak ada lagi objek yang digunakan, dan aplikasi tidak berada di bawah kontrol pengguna, server dapat ditutup. Salah satu cara untuk mengimplementasikan LockServer adalah dengan memanggil fungsi CoLockObjectExternal .Proses yang mengunci aplikasi objek bertanggung jawab untuk membuka kuncinya. Setelah objek kelas dirilis, tidak ada mekanisme yang menjamin koneksi penelepon ke kelas yang sama nanti (seperti dalam kasus di mana objek kelas terdaftar sebagai penggunaan tunggal). Penting untuk menghitung semua panggilan, bukan hanya yang terakhir, ke LockServer, karena panggilan harus seimbang sebelum mencoba melepaskan pointer ke antarmuka IClassFactory pada objek kelas atau hasil kesalahan. Untuk setiap panggilan ke LockServer dengan fLock diatur ke TRUE, harus ada panggilan ke LockServer dengan fLock diatur ke FALSE. Ketika jumlah kunci dan jumlah referensi objek kelas keduanya nol, objek kelas dapat dikosongkan.
Persyaratan
Klien minimum yang didukung | Windows 2000 Professional [aplikasi desktop | Aplikasi UWP] |
Server minimum yang didukung | Windows 2000 Server [aplikasi desktop | Aplikasi UWP] |
Target Platform | Windows |
Header | unknwnbase.h (termasuk Unknwn.h) |