CHString 类

[CHString 类是 WMI 提供程序框架的一部分，现在视为处于最终状态，对于影响这些库的非安全性相关问题，将不会提供进一步的开发、增强或更新。 所有新开发均应使用 MI API。]

下表列出了 CHString 方法。

成员

CHString 类包含以下类型的成员：

• 构造函数
• 方法
• 运算符

构造函数

CHString 类具有这些构造函数。

构造函数	说明
CHString	以各种方式构造 CHString 字符串。

方法

CHString 类具有下列方法。

方法	说明
AllocSysString	从 CHString 数据分配 BSTR。
Collate	比较两个字符串（区分大小写；使用特定于区域设置的信息）。
比较	比较两个字符串（区分大小写）。
CompareNoCase	比较两个字符串（不区分大小写）。
空	强制字符串长度为 0（零）。
查找	已重载。 在较大的字符串中查找字符或子字符串。
FindOneOf	在集中查找第一个匹配的字符。
Format	已重载。 与 sprintf 一样的方式格式化字符串。
FormatMessageW	已重载。 设置消息字符串的格式。
FormatV	与 vsprintf 一样的方式格式化字符串。
FreeExtra	通过释放以前分配给字符串的任何额外内存来消除此字符串的任何开销。
GetAllocLength	返回字符串缓冲区的大小。
GetAt	已重载。 返回位于给定位置的字符。
GetBuffer	返回指向 CHString 字符串中字符的指针。
GetBufferSetLength	返回指向 CHString 字符串中的字符的指针，并截断为指定的长度。
GetData	返回指向 CHString 字符串中数据的指针。
GetLength	返回 CHString 字符串中 Unicode 字符的数目。
IsEmpty	测试 CHString 字符串是否不包含任何字符。
Left	提取字符串的左侧部分（类似于基本函数 LEFT$）。
LoadStringW	从资源文件加载现有 CHString 字符串。
LockBuffer	禁用引用计数并保护缓冲区中的字符串。
MakeLower	将此字符串中的所有字符转换为小写字符。
MakeReverse	反转此字符串中的字符。
MakeUpper	将此字符串中的所有字符转换为大写字符。
Mid	已重载。 提取字符串的中间部分（类似于基本函数 NID$）。
ReleaseBuffer	释放对 GetBuffer 返回的缓冲区的控制。
ReverseFind	在较大的字符串中查找字符；从末尾开始。
Right	提取字符串的右侧部分（类似于基本函数 RIGHT$）。
SetAt	在给定的位置设置字符。
SpanExcluding	提取一个子字符串，其中仅包含集合中不存在的字符。
SpanIncluding	提取仅包含集中的字符的子字符串。
TrimLeft	从字符串中剪裁掉前导空白字符。
TrimRight	从字符串中剪裁掉尾部空白字符。
UnlockBuffer	启用引用计数并释放缓冲区中的字符串。

运算符

The **CHString** class has these operators.

运算符	说明
operator != (CHString, CHString)	比较两个 CHStrings 是否相等。
operator != (CHString, LPCWSTR)	将 CHString 与 LPCWSTR 进行比较是否不相等。
operator []	返回位于给定位置的字符 — GetAt. 的运算符替换项。
operator +	连接两个字符串并返回一个新字符串。
operator +=	将新字符串串联到现有字符串的末尾。
operator < (CHString, LPCWSTR)	将 CHString 与 LPCWSTR 进行比较。
operator < (CHString, CHString)	比较两 个 CHString。
operator <= (CHString, CHString)	比较两 个 CHString。
operator <= (CHString, LPCWSTR)	将 CHString 与 LPCWSTR 进行比较。
operator =	将新值分配给 CHString 字符串。
operator == (CHString, CHString)	比较两个 CHStrings 是否相等。
operator == (CHString, LPCWSTR)	将 CHString 与 LPCWSTR 进行比较是否相等。
operator > (CHString, CHString)	比较两 个 CHString。
operator > (CHString, LPCWSTR)	将 CHString 与 LPCWSTR 进行比较。
operator >= (CHString, CHString)	比较两 个 CHString。
operator >= (CHString, LPCWSTR)	将 CHString 与 LPCWSTR 进行比较。
operator LPCWSTR	直接访问作为 C 样式字符串存储在 CHString 字符串中的字符。

备注

类的析构函数为 CHString::~CHString。

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
标头	ChString.h（包括 FwCommon.h）
库	FrameDyn.lib
DLL	FrameDynOS.dll; FrameDyn.dll