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 |
| 标头 |
|
| 库 |
|
| DLL |
|