CHString 類別
[ CHString 類別是 WMI 提供者架構的一部分，現在被視為最終狀態，而且不會針對影響這些程式庫的非安全性相關問題使用進一步的開發、增強功能或更新。 MI API應該用於所有新的開發。]
下表列出 CHString 方法。
成員
CHString類別具有下列類型的成員：
建構函式
CHString類別具有這些建構函式。
| 建構函式 | 描述 |
|---|---|
| CHString | 以各種方式建構 CHString 字串。 |
方法
CHString類別具有這些方法。
| 方法 | 描述 |
|---|---|
| AllocSysString | 從 CHString 資料配置 BSTR 。 |
| 整理 | 比較兩個字串 (區分大小寫;使用地區設定特定的資訊) 。 |
| 比較 | 比較兩個字串 (區分大小寫) 。 |
| CompareNoCase | 比較兩個字串， (不區分大小寫的) 。 |
| 空白 | 強制字串長度為 0 (零) 長度。 |
| 找到 | 多載。 在較大的字串內尋找字元或子字串。 |
| FindOneOf | 從集合中尋找第一個相符字元。 |
| 格式 | 多載。 將字串格式化為 sprintf 。 |
| FormatMessageW | 多載。 格式化訊息字串。 |
| FormatV | 將字串格式化為 vsprintf 。 |
| FreeExtra | 釋放先前配置給字串的任何額外記憶體，以移除此字串的任何額外負荷。 |
| GetAllocLength | 傳回字串緩衝區的大小。 |
| GetAt | 多載。 傳回位於指定位置的字元。 |
| GetBuffer | 傳回 CHString 字串中字元的指標。 |
| GetBufferSetLength | 傳回 CHString 字串中字元的指標，並截斷為指定的長度。 |
| GetData | 傳回 CHString 字串中資料的指標。 |
| GetLength | 傳回 CHString 字串中的 Unicode 字元數目。 |
| IsEmpty | 測試 CHString 字串是否不含任何字元。 |
| 離開 | 擷取字串的左邊部分 (，例如基本 LEFT$ 函式) 。 |
| LoadStringW | 從資源檔載入現有的 CHString 字串。 |
| LockBuffer | 停用參考計數，並保護緩衝區中的字串。 |
| MakeLower | 將此字串中的所有字元轉換為小寫字元。 |
| MakeReverse | 反轉此字串中的字元。 |
| MakeUpper | 將這個字串中的所有字元轉換為大寫字元。 |
| Mid | 多載。 擷取字串的中間部分 (，例如基本 MID$ 函式) 。 |
| ReleaseBuffer | 釋放 GetBuffer所傳回之緩衝區的控制權。 |
| ReverseFind | 在較大的字串內尋找字元;從結尾開始。 |
| Right | 擷取字串的右邊部分 (，例如基本 RIGHT$ 函式) 。 |
| SetAt | 在指定位置設定字元。 |
| SpanExcluding | 擷取子字串，其中只包含不在集合中的字元。 |
| SpanIncluding | 擷取只包含集合中字元的子字串。 |
| TrimLeft | 修剪字串中的前置空白字元。 |
| TrimRight | 修剪字串中的尾端空白字元。 |
| UnlockBuffer | 啟用參考計數，並釋放緩衝區中的字串。 |
運算子
The **CHString** class has these operators.
| 運算子 | 描述 |
|---|---|
| operator ！= (CHString， CHString) | 比較兩個 CHString 來 表示不相等。 |
| operator ！= (CHString， LPCWSTR) | 比較 CHString 與 LPCWSTR 是否不相等。 |
| 運算子 [] | 傳回 GetAt之指定位置運算子替代位置的字元。 |
| 運算子 + | 串連兩個字串，並傳回新的字串。 |
| 運算子 += | 將新的字串串連至現有字串的結尾。 |
| operator < (CHString， LPCWSTR) | 比較 CHString 與 LPCWSTR。 |
| 運算子 < (CHString、 CHString) | 比較兩個 CHString。 |
| operator < = (CHString、CHString) | 比較兩個 CHString。 |
| operator < = (CHString， LPCWSTR) | 比較 CHString 與 LPCWSTR。 |
| operator = | 將新值指派給 CHString 字串。 |
| operator == (CHString， CHString) | 比較兩個 CHString 是否 相等。 |
| operator == (CHString， LPCWSTR) | 比較 CHString 與 LPCWSTR 是否相等。 |
| 運算子 > (CHString、 CHString) | 比較兩個 CHString。 |
| operator > (CHString， LPCWSTR) | 比較 CHString 與 LPCWSTR。 |
| operator > = (CHString、CHString) | 比較兩個 CHString。 |
| operator > = (CHString， LPCWSTR) | 比較 CHString 與 LPCWSTR。 |
| 運算子 LPCWSTR | 直接存取以 C 樣式字串儲存在 CHString 字串中的字元。 |
備註
類別的解構函式是 CHString：：~CHString。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista |
| 最低支援的伺服器 |
Windows Server 2008 |
| 標頭 |
|
| 程式庫 |
|
| DLL |
|