Win32 API 注册表类的编制以及使用

韩冰

一、问题的提出

Windows 已由原来的16位 windows 3.x 升级为现今我们使用的32位windows 95/97/98 ( X8 c7 @% H& E以其 Windows NT，用户不仅在使用上应逐步适应，对于程序开发人员来说在编程技术 上也应紧跟操作系统的技术发展，就如同 在 Linux 操作系统下， X-Window 编程就显 + N9 N& i$ y4 o$ t4 U5 ^: f: r得很重要一样。作为一个完整成熟的 Windows 程序，需要保存程序所有的环境变量和 私有信息。诸如用户的偏好，文件装入的列表、退出时用户使用的窗口位置 .存盘历史 纪录等。过去在 windows 3.x时代 ，常用 Win16函数 Get/RegWrite ProfileString ) F( U. h, j% Y; n将有关程序的信息写入 *.ini 文件，但现在该项技术由 Win32注册表所替代。 可以这样说，注册表是当今32位 Windows 操作系统的灵魂，一切信息都在其中，也就 是为什么Ｗｉｎｄｏｗｓ９８在Ｗｉｎｄｏｗｓ９５的基础上升级可以不重装软件等等 3 A" |3 U; F8 [9 C" i0 v& }$ n的如此方便的应用，其原理就是根据了原注册表中的信息来完成各种方便的处理，所以 Windows注册表对应用程序的重要性就显而易见了。 " |8 I7 u) N: D; y& d原来的 Win16程序存储私有信息是在一个平面文件INI中，这样做有很多弊端，例如该 # h1 y' Q3 I( Q. S( p- uINI文件没有任何安全机制，用户可以直接在INI文件中修改各种参数和程序入口，这样 就可能造成不可估计的严重后果，还有该文件只能支持和文本数据不能存入二进制数据 7 T. G. ^! W' R! ~等各种不利因素，所以微软的工程师也认识到这一点，于是注册数据库就诞生了，注册 数据库就是为了解决在 Windows 3.x 的一些关于 OLE 的此类问题而创建的，现在 ' a8 [0 W" F+ l% q4 JWin32 应用程序的注册数据库通过微软带给我们的新的 Win32 API 得到了显著的改 4 k0 K' T) R- K: ^2 a0 U* G善。使用访问注册表的 Win32 函数比起使用管理 INI 文件的 Win16函数要灵活的多， 这意味着在功能上将大大增强，但是，另一方面，如果你还未用过，就会对处理注册表 的Win32 API 的新规则感到困惑或不知所措。本文就是本着这一目的，逐步让你懂得并 掌握怎样用 Win32API 函数来处理32位 Windows 程序注册表的方法。

二 . 技术的实现原理

7 O' R3 P9 u+ i9 J7 ~# ^

为了在以后自己编写的程序中更多的体现模块化思想以及使编程变得更加简单，应尽可 能的建立自己实现各种功能的类，以类作为实现应用程序各种功能的单位。 在此，可 以创建一个包括注册表许多常用功能而接口简单的类库，下面将建立 CMyRegKey类，对 2 @' F; J- Z+ q0 x& L应用程序处理注册表的具体细节进行封装，从而在外部通过这个功能类方便地实现进行 访问注册表信息的各种操作，在外部调用其成员函数即可。以后，你就可以在每一个应 5 p! d; C" u) W j, J7 A' i用程序中包含此类并用其外部接口进行编程了。

三 . 实现代码与步骤

( l! L; b, W4 `1 }( i+ U& }

1. 建立功能类的头文件：

创建一个新的头文件 MyRegKey.h ,在其中加入以下的代码。

- l4 n$ R: k, a# N

#include "winreg.h"

// 包含头文件 winreg.h , 因注册表Win32 API 函数在其内定义

, l- c; K5 b: [4 N/ b

// 建立 CMyRegKey 类： 4 e* r7 B; s5 z( xclass CMyRegKey 2 C( m; h7 C' q{

" S* p7 h' p% W1 ^9 ?

// Construction # a: @: @: K2 K) B* Apublic: CMyRegKey(); virtual ~CMyRegKey ();

// Attributes . P4 H, q, a% b5 }public:

! _. \( l; Y4 H |6 f9 V

// 定义打开和关闭注册表的成员函数：

3 x8 D7 E5 X i+ u

LONG RegRegOpen(HKEY hKeyRoot,LPCTSTR pszPath); 4 G5 K9 q& z ~; ~void RegRegClose();

// 利用函数重载实现对注册表键值（串值，二进制值，DWORD值 ） 的读和写：

+ k4 \1 v0 Z8 D2 W

LONG RegRead (LPCTSTR pszKey,DWORD& dwVal); LONG RegRead (LPCTSTR pszKey,CString& sVal); LONG RegRead (LPCTSTR pszKey,BYTE *pData,DWORD& dwLength);

LONG RegWrite (LPCTSTR pszKey,DWORD dwVal); LONG RegWrite (LPCTSTR pszKey,LPCTSTR pszVal); LONG RegWrite (LPCTSTR pszKey,const BYTE *pData,DWORD dwLength);

# o9 C5 g! P K4 n7 }

protected: HKEY m_hKey; # N$ g$ W' _; ]8 B! W4 dCString m_sPath; };

; j1 p" `- F# Y h3 z0 t

2. 建立功能类的Cpp文件定义 CMyRegKey类：

4 O5 C. K6 x8 I" o

创建一个新文件 MyRegKey.cpp ,代码如下：

4 j0 u5 a# f$ u! g5 S# {& s

#include "MyRegKey.h"

//////////////////////////////////////////////////////////////////////////// / // CMyRegKey 1 L1 {* \( r: n6 u8 R//////////////////////////////////////////////////////////////////////////// /

0 n6 k# E' c6 [

CMyRegKey:: CMyRegKey() { 1 w, \% W- s- f. Fm_hKey = NULL; }

CMyRegKey:: ~CMyRegKey() 7 }4 x5 y: I/ l% [{ RegClose(); }

// 定义打开注册表的函数，RegOpen 函数带有两个参数：指定要访问注册表根结点的 HKEY, 以及注

5 Y: D2 c* {8 y0 N+ U* s

// 册表中信息的全路径。如果给入的路径不存在，则需创建一个新路径。从 - }. l3 f$ \; A% _. ?! ~+ I+ t7 W/ z3 `RegCreateKeyEx API函数返// 回的 HKEY 作为 m_hKey 存储。

LONG CMyRegKey::RegOpen(HKEY hKeyRoot,LPCTSTR pszPath)

{

DWORD dw; / o3 m) C; F8 p1 Y% @6 O' Qm_sPath = pszPath;

0 o# K# o" f* }

return * J2 B( N( j( }8 S: l- {RegCreateKeyEx(hKeyRoot,pszPath,0L,NULL,REG_OPTION_VOLATILE,KEY_ALL_ACCESS,N ULL, ) C- }# L3 |1 p; u) b2 A, p6 J&m_hKey,&dw); $ C. d" x4 i5 V) j1 L) H}

void CMyRegKey::RegClose() { if(m_hKey) ) B; F x$ Q0 h6 V{ . B8 P# c+ w: ?; r# l5 j# K2 J9 {, ]- aRegCloseKey (m_hKey); m_hKey = NULL;

} }

+ ?, _! x7 ^! V

LONG CMyRegKey::RegWrite(LPCTSTR pszKey,DWORD dwVal) " ?4 N; a% c& m. Z6 \0 X: i' k* k{

% b, d, P. B+ G, z

ASSERT(m_hKey);

( @1 V, n! i2 o. T4 E$ p

ASSERT(pszKey); ASSERT(pData&&dwLength>0); 2 _( t$ {) n! B, o8 t" h3 \ jASSERT(AfxIsValidAddress(pData,dwLength,FALSE));

return RegSetValueEx(m_hKey,pszKey,0L,REG_DWORD,(CONST BYTE k9 q7 K5 ]: D! N. d( {9 A*)&dwVal,sizeof(DWORD)); }

LONG CMyRegKey::RegWrite(LPCTSTR pszKey,LPCTSTR pszData) {

y# w" A5 j" _5 @- P" f+ I

ASSERT(m_hKey); ASSERT(pszKey); ASSERT(pszData);

ASSERT(pData&&dwLength>0); ASSERT(AfxIsValidAddress(pszData,strlen(pszData),FALSE));

# m4 C+ }# d: N; G

return RegSetValueEx(m_hKey,pszKey,0L,REG_SZ,(CONST BYTE *)pszData,strlen (pszData)+1);

2 ` x/ L; T& A" V

}

' g$ H( D: i8 T4 A. Q3 J

LONG CMyRegKey::RegWrite(LPCTSTR pszKey,const BYTE *pData,DWORD dwLength) {

ASSERT(m_hKey); ! l' P. q* r+ @( XASSERT(pszKey); ASSERT(AfxIsValidAddress (pData,dwLength,FALSE));

ASSERT(pData&&dwLength>0); ASSERT(AfxIsValidAddress(pData,dwLength,FALSE));

; a& L5 a. @$ ~ ]

return RegSetValueEx(m_hKey,pszKey,0L,REG_BINARY,pData,dwLength);

} LONG CMyRegKey::RegRead (LPCTSTR pszKey,DWORD& dwVal) 7 g- Q4 V' M( ^3 s7 ^- p2 T$ T$ O2 R{

ASSERT(m_hKey); # X1 F' M4 O) m# @2 ]: S0 j, EASSERT(pszKey);

( ~* z3 J/ L3 b' y3 J

DWORD dwType; DWORD dwSize = sizeof (DWORD); DWORD dwDest;

LONG LRet = RegQueryValueEx(m_hKey,(LPSTR)pszKey,NULL,&dwType,(BYTE *) &dwDest,&dwSize);

( ]+ _3 R! _6 v% @% S& w; g

if(LRet==ERROR_SUCCESS) . S$ w* Z$ x3 V$ a4 u- X- _/ pdwVal = dwDest; 6 {2 J" f- h# s* Oreturn LRet;

; M/ @6 @# U' e2 K2 r# p1 X

}

LONG CMyRegKey::RegRead (LPCTSTR pszKey,CString& sVal) {

ASSERT(m_hKey); ASSERT(pszKey);

DWORD dwType; + Q6 @ ] U" yDWORD dwSize = 200; ) {: U) E! O! r8 |3 }9 b/ }char string[200];

$ r+ R) s7 T% y

LONG IReturn = RegQueryValueEx(m_hKey,(LPSTR)pszKey,NULL,&dwType,(BYTE *) 3 d% o$ N& Y" ^( estring,&dwSize);

5 S8 y9 d4 j& j

if(IReturn==ERROR_SUCCESS)

/ W9 G7 @4 Y4 k3 ?5 M* d

sVal = string; return IReturn;

& B# ^7 k8 a5 z- x" H2 [. b: n

}

LONG CMyRegKey::RegRead (LPCTSTR pszKey,BYTE * pData,DWORD& dwLen) {

: x9 r0 H7 B W3 L( O* g. h" u

ASSERT(m_hKey); / g4 d7 w: u$ X/ K: ^. h; e DASSERT(pszKey);

DWORD dwType; 9 w/ ~% H; E/ Ereturn RegQueryValueEx(m_hKey,(LPSTR)pszKey,NULL,&dwType,pData,&dwLen);

}

在用户需要使用时只需在你的 Project 中的 SorceFile 和 HeadFile 中分别加入 MyRegKey.cpp 以及 MyRegKey.h 程序文件。

四 . 使用外部接口示例

: }- v- ^8 u* s) ~# `9 |在VC中建立一个基于对话框（Dialog Base) 的应用程序,在对话框上放上几个Edit " Y! h- K1 Q0 e8 `control 的控件，如同示例小程序 RegTech 框（见图一）, 程序执行时，首先读出注 册表信息分别显示在三个编辑栏中，为了演示写入操作，你可以在注册用户栏中重新输 入用户名，按更改完成写入，重新运行程序，查看写入是否成功。在RegTech 框中安置 $ K+ ]+ h5 {% S0 B* \0 x. U" b了三个编辑栏，ID 为 IDC_INSTALL,IDC_USERID,IDC_VERSION, - W8 {9 D$ S8 Z" `1 b8 G用ClassWizard 的Member Variable 分别加上对象参数：m_Install, m_UserID 和 m_Version. : M) r. Y" ^5 W+ U5 M; P用参数来传递注册表键值。

在初始化对话框时就应打开注册表并读取所需的信息，这三项存放路径为 a! c& q' w/ ^5 |% [* GHKEY_LOCAL_MACHINE \SOFTWARE \Microsoft \Windows \CurrentVersion下， 分别读出windows 版本号（放置于Version键值中），注册用户名（放置于 RegisteredOwner键值中），Windows 安装目录（放置于SystemRoot 键值中 ），更多 * V3 S# ~; p; n; {的信息请使用Windows 目录下的 RegEdit.exe程序.

需用到注册表类的原程序文件中加上 #inxlude " MyRegKey.h"　 即可。 在文件 RegTechDlg.cpp 中初始化对话框的地方加上以下代码打开路径并读取键值：

BOOL CRegtechDlg::OnInitDialog() {

4 l; C5 b Z- L9 I

CDialog::OnInitDialog();

8 r- I8 v& y1 }' a) p- Y; u

...................... ......................

// TOD Add extra initialization here

file://###########################################

0 i: Q6 V% h3 P

// 打开注册表路径 .

CMyRegKey regKey1,regKey2,regKey3;

* X( {& S3 I0 u g# R

regKey1.RegOpen(HKEY_LOCAL_MACHINE, _T("Software\\Microsoft\\Windows\\CurrentVersion")); regKey2.RegOpen(HKEY_LOCAL_MACHINE, , e3 y# ^4 x6 V6 @ U8 X5 C_T("Software\\Microsoft\\Windows\\CurrentVersion")); regKey3.RegOpen(HKEY_LOCAL_MACHINE, _T("Software\\Microsoft\\Windows\\CurrentVersion"));

$ N/ ? w4 D7 L* l+ t6 z, z// 读取键值并分别传递到编辑控件参数中去： ! S$ d6 T* ]+ j8 g( \: QregKey1.RegRead(_T("Version"),m_Version); - B9 B5 F& T- O" tregKey2.RegRead(_T("RegisteredOwner"),m_UserID); regKey3.RegRead(_T("SystemRoot"),m_Install); UpdateData(FALSE);

file://############################################

+ ?! L8 _) D$ R' w( ^

return TRUE; // return TRUE unless you set the focus to a control : z* T) H- `% k, m4 n! w}

8 Y6 Z7 M8 x4 K5 P2 Y1 u& r, U

在重新输入了注册用户名后，按下更改按钮（按钮控件ID_ChangeID），将完成注册表 # I ]- i- Z! S# Z5 x3 Z的写入操作：

void CRegtechDlg::OnChangeID() & l% [1 ]3 h7 S( S" t{

9 [. |) J3 s, b$ ]6 D% K* J

file://########################

9 K9 ^* n# ^* S5 P

CMyRegKey regKey;

- t4 n; y: h# \" ]# IregKey.RegOpen(HKEY_LOCAL_MACHINE, & I8 p1 l/ R0 G7 L_T("SOFTWARE\\Microsoft\\Windows\\CurrentVersion"));

6 L, f& ]' o0 e: @& H. V) C

// 传递从编辑拦输入的值并写入打开路径的指定键值名中：

* K1 P9 C8 q/ e* c0 F

UpdateData(TRUE); 0 V2 A, @2 O% I+ \8 @# SregKey.RegWrite(_T("RegisteredOwner"),m_UserID); MessageBox("更改注册用户名完毕！","Message",MB_ICONINFORMATION|MB_OK);

+ u/ |; L( Y; X& {1 A///#########################

// TOD Add your control notification handler code here

}

9 V! s u( Q% Z, [" _" J

注册表类在实际应用程序编制中使用频率极高，比如程序员自定义的文件的图标选择等 的很多地方都要用到，所以一个成熟优秀的应用程序应尽可能的适应环境及发挥操作系 统的各种优势，在此，使用win32 API对Windows灵魂--注册表存取技术的操作已完 ，你就可以利用它来完善自己的应用程序了。