共用方式為

CHString：：LockBuffer 方法 (chstring.h)

  • 發行項

[ CHString 類別是 WMI 提供者架構的一部分，現在被視為最終狀態，而且不會針對影響這些連結庫的非安全性相關問題使用進一步的開發、增強功能或更新。 MI API 應該用於所有新的開發。]

LockBuffer 方法會鎖定緩衝區中的字串。

Syntax

LPWSTR LockBuffer();

傳回值

傳回 CHString 物件或 NULL 終止字串的指標。

備註

藉由呼叫 LockBuffer，您可以建立字串的複本，然後將參考計數設定為 -1。

當參考計數設定為 -1 時，緩衝區中的字串會被視為處於鎖定狀態，以下列兩種方式保護字串：

  • 即使該字串已指派給鎖定字串，其他字串也無法取得鎖定字串中數據的參考。
  • 鎖定字串永遠不會參考另一個字串，即使該其他字串複製到鎖定的字串也一樣。
藉由鎖定緩衝區中的字串，可確保字串的獨佔保留會保持不變。

完成 LockBuffer之後，請呼叫 UnlockBuffer 將參考計數重設為 1 (一個) 。

規格需求

需求 值
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
目標平台 Windows
標頭 chstring.h (include FwCommon.h)
程式庫 FrameDyn.lib
Dll FrameDynOS.dll;FrameDyn.dll

另請參閱

CHString

CHString：：UnlockBuffer