C++ Builder 操作 Windows 登錄表完整指南：TRegistry 類深度解析

Windows 登錄表儲存了系統配置、硬體資訊、應用程式設定及使用者偏好等關鍵資料，呈現六大根鍵下的樹狀結構。在 C++ Builder 中操作登錄表的核心在於掌握 VCL 提供的 TRegistry 類，本文將系統梳理其關鍵用法與最佳實踐。

TRegistry 實例的建立與根鍵設定

與 VC++ 直接使用 HKEY 不同，C++ Builder 必須使用 new 關鍵字動態建立實例：

TRegistry *curReg = new TRegistry; // curReg 為 TRegistry 指標

預設情況下，RootKey 屬性指向 HKEY_CURRENT_USER。若需操作其他根鍵（如 HKEY_LOCAL_MACHINE），直接賦值即可：curReg->RootKey = HKEY_LOCAL_MACHINE;。

開啟、建立與關閉鍵值

OpenKey() - 開啟或建立鍵

bool OpenKey(const AnsiString Key, bool CanCreate);

• Key：支援絕對路徑（以 \ 開頭）與相對路徑（相對於目前鍵）。
• CanCreate：true 時若鍵不存在則建立；false 時不存在則返回 false。

OpenKeyReadOnly() - 唯讀開啟鍵

參數為 NULL 時指向 RootKey 指定的鍵。

CloseKey() 與記憶體釋放

操作完成後必須呼叫 CloseKey() 關閉登錄表，並用 delete 釋放 new 配置的記憶體。

枚舉子鍵與讀寫數值

GetKeyNames() - 取得所有子鍵名稱

參數型別為 TStrings*，但 TStrings 含抽象成員，無法直接實例化。解決方案：使用其派生類 TStringList：

TStringList *KeyNames = new TStringList;
curReg->GetKeyNames(KeyNames);
// 遍歷 KeyNames->Strings[i] 取得子鍵名
delete KeyNames;

讀寫具體數值

結合 GetValueNames()、ReadString()、WriteString() 等方法。範例：讀取 \Software\Sybase 下的 Location 字串值：

curReg->OpenKey("\\Software\\Sybase", true);
AnsiString ValueInfo = curReg->ReadString("Location");

關鍵屬性：LazyWrite 與 RootKey

• LazyWrite：預設 true，寫入操作不立即反映到實體登錄表，而是在 CloseKey() 時批量寫入以提升效能。若需即時生效，設為 false 後再執行寫入。
• RootKey：指定目前操作的根鍵，預設 HKEY_CURRENT_USER。

完整程式碼範例：將子鍵名稱填入 ComboBox

#include <registry.hpp>
// ...
TRegistry *curReg = new TRegistry;
curReg->OpenKey("Software\\MyInfo", true);
TStringList *KeyNames = new TStringList();
curReg->GetKeyNames(KeyNames);
for (int i = 0; i < KeyNames->Count; i++)
    ComboBox1->Items->Add(KeyNames->Strings[i]);
curReg->CloseKey();
delete KeyNames;
delete curReg;

善用 TRegistry 類，配合 C++ Builder 強大的類別庫，即可輕鬆實現登錄表的讀寫、枚舉與管理，為應用程式提供靈活的配置儲存方案。