Metode IClassFactory::LockServer (unknwn.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

Persyaratan	Nilai
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	unknwn.h (termasuk Unknwn.h)

Lihat juga

CoLockObjectExternal

IClassFactory