Поделиться через

Метод CHString::LockBuffer (chstring.h)

  • Статья

[Класс CHString является частью платформы поставщика WMI, которая в настоящее время рассматривается в окончательном состоянии, и никакие дальнейшие разработки, улучшения или обновления не будут доступны для проблем, не связанных с безопасностью, влияющих на эти библиотеки. API mi mi следует использовать для всех новых разработок.]

Метод LockBuffer блокирует строку в буфере.

Синтаксис

LPWSTR LockBuffer();

Возвращаемое значение

Возвращает указатель на объект CHString или строку, завершающуюся значением NULL.

Комментарии

Вызывая LockBuffer, вы создаете копию строки, а затем устанавливаете для счетчика ссылок значение -1.

Если для счетчика ссылок задано значение -1, строка в буфере считается заблокированной, что защищает строку двумя способами:

  • Никакая другая строка не может получить ссылку на данные в заблокированной строке, даже если эта строка назначена заблокированной строке.
  • Заблокированная строка никогда не ссылается на другую строку, даже если эта другая строка копируется в заблокированную строку.
Блокируя строку в буфере, вы гарантируете, что монопольное удержание строки в буфере остается неизменным.

Завершив работу с LockBuffer, вызовите UnlockBuffer , чтобы сбросить число ссылок на 1 (один).

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Целевая платформа Windows
Header chstring.h (включая FwCommon.h)
Библиотека FrameDyn.lib
DLL FrameDynOS.dll; FrameDyn.dll

См. также раздел

CHString

CHString::UnlockBuffer