註冊表API簡易教程

時間 2019-11-08

原文原文鏈接

術語對照windows

註冊表操做經常使用API

API	說明
RegCreateKey	建立一個KEY，並返回相應的HKEY
RegOpenKey	打開註冊表，獲得一個HKEY，用來做爲下面這些函數的第一個參數。
RegOpenKeyEx	同RegOpenKey相似，通常不多用，增長了一個訪問控制類型參數。
RegSetValue	設置一個HKEY的默認值
RegSetValueEx	設置一個HKEY除默認值之外其它的值
RegQueryValue	獲取一個HKEY的默認值
RegQueryValueEx	獲取一個HKEY除默認值之外其它的值
RegDeleteKey	刪除一個KEY，此KEY不能包含子KEY
SHDeleteKey	刪除一個KEY以及全部子KEY
RegDeleteValue	刪除KEY裏面的值
RegCloseKey	關閉註冊表

註冊表數據類型

類型	說明
REG_DWORD	32位數字
REG_SZ	以NULL結尾的字符串，它能夠爲Unicode或ANSI字符串，取決因而否使用的是Unicode仍是ANSI函數。

函數用法

RegCreateKey
```
LONG RegCreateKey(
  HKEY hKey,        // handle to an open key
  LPCTSTR lpSubKey, // subkey name
  PHKEY phkResult   // buffer for key handle
);
```
假如咱們要將demo程序的許多相機參數保存到：HKEY_LOCAL_MACHINE\SOFTWARE\daheng_directx，使用這個函數來建立指定的key，獲得對於的HKEY以便進一步操做。api
```
HKEY hKey;
if (RegCreateKey(HKEY_LOCAL_MACHINE, "Software\\daheng_directx", &hKey) == ERROR_SUCCESS) {
// 在這裏就可使用hKey來操做daheng_directx這個KEY裏面的值了。
}
RegCloseKey(hKey);
```
注意：通常程序常常保持數據的位置有：HKEY_LOCAL_MACHINE\SOFTWARE和HKEY_CURRENT_USER\Software，二者的區別爲：前者保持的數據，操做系統上的全部帳戶均可以訪問（好比你的機器上有兩個帳戶，一個是徐藝波，一個是康康，假如你將註冊表保存在HKEY_LOCAL_MACHINE\SOFTWARE，那麼當系統以徐藝波的帳戶登陸加入後，運行demo和進入康康運行demo，獲取的初始值都是同樣的。），而HKEY_CURRENT_USER\Softwar是針對當前帳戶的，系統以不一樣的帳戶登陸，這個KEY下面的值是不同的。 ide
RegOpenKey
```
LONG RegOpenKey(
  HKEY hKey,        // handle to open key
  LPCTSTR lpSubKey, // name of subkey to open
  PHKEY phkResult   // handle to open key
);
```
這個函數不一樣於RegCreateKey的地方在於，若是這個KEY不存在，那麼此函數執行失敗（而RegCreateKey：存在的話，返回存在的HKEY；不存在，建立一個並返回其HKEY）。假如咱們要將demo程序的許多相機參數保存到：HKEY_LOCAL_MACHINE\SOFTWARE\daheng_directx，使用這個函數來打開指定的key，獲得對於的HKEY以便進一步操做。函數
```
HKEY hKey;
if (RegOpenKey(HKEY_LOCAL_MACHINE, "Software\\daheng_directx", &hKey) == ERROR_SUCCESS) {
// 在這裏就可使用hKey來操做daheng_directx這個KEY裏面的值了。
}
RegCloseKey(hKey);
```

RegSetValueEx

LONG RegSetValueEx(
  HKEY hKey,           // handle to key
  LPCTSTR lpValueName, // value name
  DWORD Reserved,      // reserved
  DWORD dwType,        // value type
  CONST BYTE *lpData,  // value data
  DWORD cbData         // size of value data
);

假設咱們要保持相機曝光數據到HKEY_LOCAL_MACHINE\SOFTWARE\daheng_directx，數據名爲AEC，值爲1：this

HKEY hKey;
    HKEY hSubKey;
    DWORD dwValue = 1;
    char Buffer[] = "raw2rgb.dll";
    
    // 使用RegCreateKey能保證若是Software\daheng_directx不存在的話，建立一個。
    if (RegCreateKey(HKEY_LOCAL_MACHINE, "Software\\daheng_directx", &hKey) == ERROR_SUCCESS) {
        //
        // 在這裏就可使用hKey來操做daheng_directx這個KEY裏面的值了。
        //

        if (RegSetValueEx(hKey, "AEC", 0, REG_DWORD, (CONST BYTE*)&dwValue, sizeof(DWORD)) == ERROR_SUCCESS) {
            printf("RegSetValueEx: AEC = %d\n", dwValue);
        }

        //
        // 若是想在Software\\daheng_directx建立一個plugins key，那麼就不能再使用hKey了，須要
        // 從新獲取這個結點的HKEY。
        //
        
        if (RegCreateKey(hKey, "plugins", &hSubKey) == ERROR_SUCCESS) {
            if (RegSetValueEx(hSubKey, "顏色校訂插件", 0, REG_SZ, (CONST BYTE*)Buffer,strlen(Buffer) + 1) == ERROR_SUCCESS) {
                printf("RegSetValueEx: 顏色校訂插件 = %s\n", Buffer);
            }
            RegCloseKey(hSubKey);
        }
    }
    RegCloseKey(hKey);

RegQueryValueEx

LONG RegQueryValueEx(
  HKEY hKey,            // handle to key
  LPCTSTR lpValueName,  // value name
  LPDWORD lpReserved,   // reserved
  LPDWORD lpType,       // type buffer
  LPBYTE lpData,        // data buffer
  LPDWORD lpcbData      // size of data buffer
);

假設咱們要讀取上面設置RegSetValueEx設置的值：操作系統

 HKEY hKey;
    HKEY hSubKey;
    DWORD dwType;
    DWORD dwValue;
    DWORD dwSize;
    // 使用RegCreateKey能保證若是Software\daheng_directx不存在的話，建立一個。
    if (RegOpenKey(HKEY_LOCAL_MACHINE, "Software\\daheng_directx", &hKey) == ERROR_SUCCESS) {
        //
        // 在這裏就可使用hKey來操做daheng_directx這個KEY裏面的值了。
        //

        dwType = REG_DWORD;
        dwSize = sizeof(DWORD);
        if (RegQueryValueEx(hKey, "AEC", 0, &dwType, &dwValue, &dwSize) == ERROR_SUCCESS) {
            printf("RegQueryValueEx AEC = %d\n", dwValue);
        } else {
            printf("Some error occurred!\n");
        }

        //
        // 若是想在Software\\daheng_directx建立一個plugins key，那麼就不能再使用hKey了，須要
        // 從新獲取這個結點的HKEY。
        //

        if (RegOpenKey(hKey, "plugins", &hSubKey) == ERROR_SUCCESS) {
            char Buffer[256];
            dwType = REG_SZ;
            dwSize = sizeof(Buffer);
            if (RegQueryValueEx(hSubKey, "顏色校訂插件", 0, &dwType, (LPBYTE)Buffer, &dwSize) == ERROR_SUCCESS) {
                    printf("RegQueryValueEx 顏色校訂插件 = %s\n", Buffer);
            } else {
                    printf("Some error occurred!\n");
            }
            RegCloseKey(hSubKey);
        }
    }
    RegCloseKey(hKey);

RegDeleteKey

LONG RegDeleteKey(
  HKEY hKey,         // handle to open key
  LPCTSTR lpSubKey   // subkey name
);

假設咱們要刪除RegSetValueEx設置的KEY：插件

 RegDeleteKey (HKEY_LOCAL_MACHINE, "Software\\daheng_directx");

SHDeleteKey

LONG SHDeleteKey(
  HKEY hKey,         // handle to open key
  LPCTSTR lpSubKey   // subkey name
);

假設咱們要刪除RegSetValueEx設置的KEY以及全部子KEY：3d

 SHDeleteKey (HKEY_LOCAL_MACHINE, "Software\\daheng_directx");

RegDeleteValue

LONG RegDeleteValue(
  HKEY hKey,            // handle to key
  LPCTSTR lpValueName   // value name
);

假設咱們要刪除上面設置RegSetValueEx設置的值：code

    HKEY hKey;
    HKEY hSubKey;
    DWORD dwType;
    DWORD dwValue;
    DWORD dwSize;
    // 使用RegCreateKey能保證若是Software\daheng_directx不存在的話，建立一個。
    if (RegOpenKey(HKEY_LOCAL_MACHINE, "Software\\daheng_directx", &hKey) == ERROR_SUCCESS) {
        dwType = REG_DWORD;
        dwSize = sizeof(DWORD);
        if (RegDeleteValue(hKey, "AEC") == ERROR_SUCCESS) {
            printf("RegDeleteValue AEC = %d\n", dwValue);
        } else {
            printf("Some error occurred!\n");
        }
    }
    RegCloseKey(hKey);

RegCloseKey

LONG RegCloseKey(
  HKEY hKey   // handle to key to close
);

HKEY hKey;
if (RegCreateKey(HKEY_LOCAL_MACHINE, "Software\\daheng_directx", &hKey) == ERROR_SUCCESS) {
      // …
}
RegCloseKey(hKey);

這個函數比較簡單，參數1爲RegCreateKey、RegOpenKey、RegCreateKeyEx、RegOpenKeyEx函數返回的HKEY。blog

實例

/*++

Copyright (c) 2007 http://www.xuyibo.org

Module Name:

    reg.c

Abstract:

    Small registry demo for my good friend LiuMin ;)

Author:

    xuyibo (xuyibo) 2007-05-15

Revision History:

--*/

#include <stdio.h>
#include <windows.h>
#pragma comment(lib, "advapi32.lib")

void SetRegistryValue()
{
    HKEY hKey;
    HKEY hSubKey;
    DWORD dwValue = 1;
    char Buffer[] = "raw2rgb.dll";
    
    // 使用RegCreateKey能保證若是Software\daheng_directx不存在的話，建立一個。
    if (RegCreateKey(HKEY_LOCAL_MACHINE, "Software\\daheng_directx", &hKey) == ERROR_SUCCESS) {
        //
        // 在這裏就可使用hKey來操做daheng_directx這個KEY裏面的值了。
        //

        if (RegSetValueEx(hKey, "AEC", 0, REG_DWORD, (CONST BYTE*)&dwValue, sizeof(DWORD)) == ERROR_SUCCESS) {
            printf("RegSetValueEx: AEC = %d\n", dwValue);
        }

        //
        // 若是想在Software\\daheng_directx建立一個plugins key，那麼就不能再使用hKey了，須要
        // 從新獲取這個結點的HKEY。
        //
        
        if (RegCreateKey(hKey, "plugins", &hSubKey) == ERROR_SUCCESS) {
            if (RegSetValueEx(hSubKey, "顏色校訂插件", 0, REG_SZ, (CONST BYTE*)Buffer,strlen(Buffer) + 1) == ERROR_SUCCESS) {
                printf("RegSetValueEx: 顏色校訂插件 = %s\n", Buffer);
            }
            RegCloseKey(hSubKey);
        }
    }
    RegCloseKey(hKey);
}

void GetRegistryValue()
{
    HKEY hKey;
    HKEY hSubKey;
    DWORD dwType;
    DWORD dwValue;
    DWORD dwSize;
    // 使用RegCreateKey能保證若是Software\daheng_directx不存在的話，建立一個。
    if (RegOpenKey(HKEY_LOCAL_MACHINE, "Software\\daheng_directx", &hKey) == ERROR_SUCCESS) {
        //
        // 在這裏就可使用hKey來操做daheng_directx這個KEY裏面的值了。
        //

        dwType = REG_DWORD;
        dwSize = sizeof(DWORD);
        if (RegQueryValueEx(hKey, "AEC", 0, &dwType, &dwValue, &dwSize) == ERROR_SUCCESS) {
            printf("RegQueryValueEx AEC = %d\n", dwValue);
        } else {
            printf("Some error occurred!\n");
        }

        //
        // 若是想在Software\\daheng_directx建立一個plugins key，那麼就不能再使用hKey了，須要
        // 從新獲取這個結點的HKEY。
        //

        if (RegOpenKey(hKey, "plugins", &hSubKey) == ERROR_SUCCESS) {
            char Buffer[256];
            dwType = REG_SZ;
            dwSize = sizeof(Buffer);
            if (RegQueryValueEx(hSubKey, "顏色校訂插件", 0, &dwType, (LPBYTE)Buffer, &dwSize) == ERROR_SUCCESS) {
                    printf("RegQueryValueEx 顏色校訂插件 = %s\n", Buffer);
            } else {
                    printf("Some error occurred!\n");
            }
            RegCloseKey(hSubKey);
        }
    }
    RegCloseKey(hKey);
}

int main(int argc, char* argv[])
{
    SetRegistryValue();
    GetRegistryValue();
    
    getchar();
    return 0;
}

運行結果：