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

另请参阅

CHString

CHString::UnlockBuffer