| 函數 | 用途 | 關鍵參數 |
| RegOpenKeyEx | 打開註冊表鍵 | hKey、lpSubKey、ulOptions、samDesired、phkResult |
| RegQueryValueEx | 讀取鍵值數據 | hKey、lpValueName、lpReserved、lpType、lpData、lpcbData |
| RegSetValueEx | 寫入/修改鍵值 | hKey、lpValueName、Reserved、dwType、lpData、cbData |
| RegCloseKey | 關閉鍵句柄 | hKey |
| RegCreateKeyEx | 創建或打開鍵 | 含安全屬性、創建選項 |
| RegDeleteKeyValue | 刪除鍵值 | Windows Vista+ |
一、讀取鍵值標準雙調用模式
RegQueryValueEx 必須調用兩次:
- 首次傳
lpData=NULL 獲取所需緩衝區大小 lpcbData
- 分配內存後二次調用讀取實際數據
完整示例:讀取系統 PATH 環境變量
#include
#include
#include
#include
int ReadSystemPath() {
HKEY hk;
LONG result;
DWORD dataSize = 0;
TCHAR *value = NULL;
// 1. 打開鍵:HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Environment
result = RegOpenKeyEx(
HKEY_LOCAL_MACHINE,
_T("SYSTEM\\CurrentControlSet\\Control\\Session Manager\\Environment"),
0,
KEY_READ, // 權限:讀取
&hk
);
if (result != ERROR_SUCCESS) {
_tprintf(_T("RegOpenKeyEx failed: %ld\n"), result);
if (result == ERROR_FILE_NOT_FOUND) MessageBox(NULL, _T("Key not found"), _T("Error"), MB_ICONWARNING);
return 1;
}
// 2. 首次調用:獲取數據大小
result = RegQueryValueEx(
hk,
_T("Path"),
NULL,
NULL, // 不需要類型
NULL, // lpData = NULL
&dataSize // 接收字節數
);
if (result != ERROR_SUCCESS && result != ERROR_MORE_DATA) {
_tprintf(_T("RegQueryValueEx (size) failed: %ld\n"), result);
RegCloseKey(hk);
return 1;
}
// 3. 分配緩衝區(TCHAR 數組,含終止符)
value = (TCHAR*)malloc(dataSize);
if (!value) {
_tprintf(_T("Memory allocation failed\n"));
RegCloseKey(hk);
return 1;
}
// 4. 二次調用:讀取實際數據
result = RegQueryValueEx(
hk,
_T("Path"),
NULL,
NULL,
(LPBYTE)value,
&dataSize
);
if (result != ERROR_SUCCESS) {
_tprintf(_T("RegQueryValueEx (data) failed: %ld\n"), result);
free(value);
RegCloseKey(hk);
return 1;
}
// 5. 使用數據
_tprintf(_T("System Path: %s\n"), value);
// SetWindowText(hwndEdit, value); // GUI 顯示
// 6. 清理
free(value);
RegCloseKey(hk);
return 0;
}
二、寫入鍵值
LONG WriteRegistryValue(HKEY root, LPCTSTR subKey, LPCTSTR valueName, DWORD type, const BYTE* data, DWORD dataSize) {
HKEY hk;
LONG result = RegCreateKeyEx(root, subKey, 0, NULL, REG_OPTION_NON_VOLATILE, KEY_WRITE, NULL, &hk, NULL);
if (result != ERROR_SUCCESS) return result;
result = RegSetValueEx(hk, valueName, 0, type, data, dataSize);
RegCloseKey(hk);
return result;
}
// 用法:寫入字符串值
TCHAR newPath[] = _T("C:\\MyApp;%PATH%");
WriteRegistryValue(HKEY_CURRENT_USER, _T("Environment"), _T("Path"), REG_EXPAND_SZ, (BYTE*)newPath, (lstrlen(newPath)+1)*sizeof(TCHAR));
三、新手常見錯誤與解決
| 錯誤碼 | 符號常量 | 原因 | 解決 |
| 5 | ERROR_ACCESS_DENIED | 權限不足 | 打開鍵時使用 KEY_WRITE/KEY_ALL_ACCESS;以管理員運行進程;檢查鍵 ACL |
| 2 | ERROR_FILE_NOT_FOUND | 鍵或值不存在 | 確認路徑拼寫、大小寫、紅絲帶鍵名 |
| 234 | ERROR_MORE_DATA | 緩衝區太小 | 雙調用模式:首次獲取大小,分配後二次讀取 |
| 87 | ERROR_INVALID_PARAMETER | 參數無效(如類型不匹配) | 檢查 dwType 與數據格式匹配:REG_SZ/REG_DWORD/REG_BINARY |
| 998 | ERROR_NOACCESS | 指針無效 | 確保 lpData 指向有效內存,lpcbData 指向有效 DWORD |
四、最佳實踐清單
- 總是檢查返回值,非
ERROR_SUCCESS 即失敗
- 雙調用讀取字符串/二進制,避免緩衝區溢出或截斷
- 使用 KEY_READ/KEY_WRITE 最小權限,避免
KEY_ALL_ACCESS
- 及時 RegCloseKey,防止句柄洩漏
- 字符串類型選擇:
REG_SZ 普通、REG_EXPAND_SZ 含環境變量、REG_MULTI_SZ 多字符串
- 64/32 位視圖: 32 位進程訪問 64 位註冊表需
KEY_WOW64_64KEY 旗標
五、註冊表重定向(WoW64)
// 32位應用訪問 64位註冊表
RegOpenKeyEx(HKEY_LOCAL_MACHINE, subKey, 0, KEY_READ | KEY_WOW64_64KEY, &hk);
// 32位應用訪問 32位註冊表(默認重定向)
RegOpenKeyEx(HKEY_LOCAL_MACHINE, subKey, 0, KEY_READ | KEY_WOW64_32KEY, &hk);
總結
Windows 註冊表 API 核心在於 雙調用讀取、精確權限控制、嚴格錯誤碼處理、64/32 位視圖隔離。掌握 RegOpenKeyEx → RegQueryValueEx×2 → RegCloseKey 標準流程,配合 RegCreateKeyEx 寫入,即可構建健壯的註冊表操作模塊。建議封裝為 RAII 風格 C++ 類或輔助函數庫復用。
copyright ©
萬盛學電腦網 all rights reserved