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 |