注册表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;
}

运行结果：