CRegKey选件类

项目
02/21/2013

此选件类为操作系统注册表的项的方法。

重要

此选件类及其成员不能在Windows运行时执行的应用程序。

class CRegKey

成员

公共构造函数

名称	说明
CRegKey::CRegKey	构造函数。
CRegKey::~CRegKey	该析构函数。

公共方法

名称	说明
CRegKey::Attach	调用此方法HKEY附加到 CRegKey 对象通过设置 m_hKey 成员句柄 hKey。
CRegKey::Close	调用此方法释放 m_hKey 成员处理并将其设置为NULL。
CRegKey::Create	如果它不存在)，作为 hKeyParent，child调用此方法创建指定的键。
CRegKey::DeleteSubKey	调用此方法从注册表中移除指定的键。
CRegKey::DeleteValue	调用此方法从 m_hKey移除值字段中。
CRegKey::Detach	调用此方法分离 CRegKey 对象的 m_hKey 成员句柄和设置 m_hKey 为NULL。
CRegKey::EnumKey	调用此方法枚举打开注册表项的子级。
CRegKey::Flush	调用此方法以打开注册表项的属性编写所有到注册表。
CRegKey::GetKeySecurity	调用此方法检索保护打开注册表项的安全说明符的副本。
CRegKey::NotifyChangeKeyValue	此方法通知更改的调用方可以打开注册表项的属性或目录。
CRegKey::Open	调用此方法以打开指定的键和设置 m_hKey 到此密钥句柄。
CRegKey::QueryBinaryValue	调用此方法检索指定值名称的二进制数据。
CRegKey::QueryDWORDValue	调用此方法检索一个数据为指定值名称。
CRegKey::QueryGUIDValue	调用此方法检索GUID数据为指定值名称。
CRegKey::QueryMultiStringValue	调用此方法检索multistring的数据为指定值名称。
CRegKey::QueryQWORDValue	调用此方法检索QWORD数据为指定值名称。
CRegKey::QueryStringValue	调用此方法检索字符串数据为指定值名称。
CRegKey::QueryValue	调用此方法检索数据。m_hKey的字段指定值。此方法的早期版本不再支持和标记为 ATL_DEPRECATED。
CRegKey::RecurseDeleteKey	调用此方法从注册表中移除指定的密钥和显式移除所有子级。
CRegKey::SetBinaryValue	调用此方法设置注册表项的二进制值。
CRegKey::SetDWORDValue	调用此方法设置注册表项的DWORD值。
CRegKey::SetGUIDValue	调用此方法设置注册表项的GUID值。
CRegKey::SetKeySecurity	调用此方法设置注册表项的安全性。
CRegKey::SetKeyValue	调用此方法将数据存储在指定值指定的键字段。
CRegKey::SetMultiStringValue	调用此方法设置注册表项的multistring的值。
CRegKey::SetQWORDValue	调用此方法设置注册表项的QWORD值。
CRegKey::SetStringValue	调用此方法设置注册表项的字符串值。
CRegKey::SetValue	调用此方法将数据存储在 m_hKey的字段指定值。此方法的早期版本不再支持和标记为 ATL_DEPRECATED。

公共运算符

名称	说明
CRegKey::operator HKEY	转换为HKEY的一 CRegKey 对象。
CRegKey::operator =	赋值运算符。

公共数据成员

名称	说明
CRegKey::m_hKey	包含注册表项的处理与 CRegKey 对象。
CRegKey::m_pTM	为 CAtlTransactionManager 对象的指针

备注

CRegKey 用于创建和delete键和值的方法在系统注册表。注册表包含安装一组特定系统组件的定义，如软件版本号，安装的硬件和COM对象逻辑以实际映射。

CRegKey 提供编程接口将写入系统注册表为特定计算机。例如，打开一个特殊的注册表项，请调用 CRegKey::Open。若要检索或修改数据值，则调用 CRegKey::QueryValue 或 CRegKey::SetValue，分别。若要关闭密钥，请调用 CRegKey::Close。

在关闭键时，其注册表数据写入硬盘写入(刷新）。此过程可能需要几秒。如果应用程序必须显式写入注册表数据传递到硬盘，可以调用 RegFlushKey Win32函数。但是，RegFlushKey 使用许多系统资源，并应调用，仅当绝对必要。

安全说明
允许调用方指定注册表位置的所有方法可能能读取不信任的数据。利用 RegQueryValueEx 的方法应考虑到此函数没有显式终止的NULL的处理字符串。应检查两个条件由调用代码。

要求

Header: atlbase.h

请参见

通过