CHString::LockBuffer 方法 (chstring.h)
[CHString 类是 WMI 提供程序框架的一部分,现在视为处于最终状态,对于影响这些库的非安全性相关问题,将不会提供进一步的开发、增强或更新。 所有新开发均应使用 MI API。]
LockBuffer 方法锁定缓冲区中的字符串。
语法
LPWSTR LockBuffer();
返回值
返回指向 CHString 对象或 以 NULL 结尾的字符串的指针。
注解
通过调用 LockBuffer,可以创建字符串的副本,然后将引用计数设置为 -1。
当引用计数设置为 -1 时,缓冲区中的字符串被视为处于锁定状态,这可通过以下两种方式保护字符串:
- 其他字符串都不可以获取对已锁定字符串中的数据的引用,即使该字符串已分配到锁定的字符串。
- 锁定的字符串永远不会引用另一个字符串,即使该其他字符串被复制到锁定的字符串也是如此。
完成 LockBuffer 后,调用 UnlockBuffer 将引用计数重置为 1 (一) 。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista |
最低受支持的服务器 | Windows Server 2008 |
目标平台 | Windows |
标头 | chstring.h (包括 FwCommon.h) |
Library | FrameDyn.lib |
DLL | FrameDynOS.dll;FrameDyn.dll |