Bagikan melalui


CHString::Metode LockBuffer (chstring.h)

[Kelas CHString adalah bagian dari Kerangka Kerja Penyedia WMI yang sekarang dipertimbangkan dalam status akhir, dan tidak ada pengembangan, peningkatan, atau pembaruan lebih lanjut yang akan tersedia untuk masalah terkait non-keamanan yang memengaruhi pustaka ini. API MI harus digunakan untuk semua pengembangan baru.]

Metode LockBuffer mengunci string di buffer.

Sintaks

LPWSTR LockBuffer();

Mengembalikan nilai

Mengembalikan penunjuk ke objek CHString atau string yang dihentikan NULL.

Keterangan

Dengan memanggil LockBuffer, Anda membuat salinan string lalu mengatur jumlah referensi ke -1.

Ketika jumlah referensi diatur ke -1, string dalam buffer dianggap dalam keadaan terkunci, yang melindungi string dengan dua cara berikut:

  • Tidak ada string lain yang bisa mendapatkan referensi ke data dalam string terkunci, bahkan jika string tersebut ditetapkan ke string terkunci.
  • String terkunci tidak pernah mereferensikan string lain, bahkan jika string lain disalin ke string yang dikunci.
Dengan mengunci string di buffer, Anda memastikan bahwa penangguhan eksklusif string pada buffer tetap utuh.

Setelah Anda selesai dengan LockBuffer, panggil UnlockBuffer untuk mengatur ulang jumlah referensi menjadi 1 (satu).

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista
Server minimum yang didukung Windows Server 2008
Target Platform Windows
Header chstring.h (termasuk FwCommon.h)
Pustaka FrameDyn.lib
DLL FrameDynOS.dll; FrameDyn.dll

Lihat juga

CHString

CHString::UnlockBuffer