35.3. _winreg — Windows 注册表访问 ¶

注意

The _winreg module has been renamed to winreg in Python 3. The 2to3 tool will automatically adapt imports when converting your sources to Python 3.

2.0 版新增。

这些函数把 Windows 注册表 API 暴露给 Python。代替使用整数作为注册表句柄， 句柄对象 被用于确保正确关闭句柄，即使程序员疏忽明确关闭它们。

本模块提供了下列函数：

_winreg. CloseKey ( hkey ) ¶

关闭先前打开的注册表键。 hkey 自变量指定先前打开键。

注意

若 hkey 不被关闭使用此方法 (或凭借 hkey.Close() )，它被关闭当 hkey 对象被 Python 销毁。

_winreg. ConnectRegistry ( computer_name , key ) ¶

建立到另一台计算机上的预定义注册表句柄的连接，并返回 句柄对象 .

computer_name 是远程计算机名，形式 r"\\computername" 。若 None ，使用本地计算机。

key 是要连接的预定义句柄。

The return value is the handle of the opened key. If the function fails, a WindowsError 异常被引发。

_winreg. CreateKey ( key , sub_key ) ¶

创建或打开指定键，返回 句柄对象 .

key 是已打开键，或某一预定义 HKEY_* 常量 .

sub_key 是由此方法打开或创建的键名称字符串。

若 key 是预定义键之一， sub_key 可以是 None 。在此情况下，返回的句柄与传入函数的键句柄相同。

若键已存在，此函数打开现有键。

The return value is the handle of the opened key. If the function fails, a WindowsError 异常被引发。

_winreg. CreateKeyEx ( key , sub_key [ , res [ , sam ] ] ) ¶

创建或打开指定键，返回 句柄对象 .

key 是已打开键，或某一预定义 HKEY_* 常量 .

sub_key 是由此方法打开或创建的键名称字符串。

res 是预留整数，且必须为 0。默认 0。

sam 是指定访问掩码 (描述键期望的安全访问) 的整数。默认为 KEY_ALL_ACCESS 。见 访问权 了解其它允许值。

若 key 是预定义键之一， sub_key 可以是 None 。在此情况下，返回的句柄与传入函数的键句柄相同。

若键已存在，此函数打开现有键。

The return value is the handle of the opened key. If the function fails, a WindowsError 异常被引发。

2.7 版新增。

_winreg. DeleteKey ( key , sub_key ) ¶

删除指定键。

key is an already open key, or any one of the predefined HKEY_* 常量 .

sub_key 是必须为键子键的字符串，标识通过 key 参数。此值不得为 None ，且键可能没有子键。

此方法无法删除带子键的键。

If the method succeeds, the entire key, including all of its values, is removed. If the method fails, a WindowsError 异常被引发。

_winreg. DeleteKeyEx ( key , sub_key [ , sam [ , res ] ] ) ¶

删除指定键。

注意

The DeleteKeyEx() 函数是采用 RegDeleteKeyEx Windows API 函数实现的，特定于 64 位版本的 Windows。见 RegDeleteKeyEx 文档编制 .

key is an already open key, or any one of the predefined HKEY_* 常量 .

sub_key 是必须为键子键的字符串，标识通过 key 参数。此值不得为 None ，且键可能没有子键。

res 是预留整数，且必须为 0。默认 0。

sam 是指定访问掩码 (描述键期望的安全访问) 的整数。默认为 KEY_WOW64_64KEY 。见 访问权 了解其它允许值。

此方法无法删除带子键的键。

If the method succeeds, the entire key, including all of its values, is removed. If the method fails, a WindowsError 异常被引发。

在不支持的 Windows 版本， NotImplementedError 被引发。

2.7 版新增。

_winreg. DeleteValue ( key , 值 ) ¶

从注册表键移除命名值。

key 是已打开键，或某一预定义 HKEY_* 常量 .

value 是标识要移除值的字符串。

_winreg. EnumKey ( key , index ) ¶

枚举打开注册表键的子键，返回字符串。

key is an already open key, or any one of the predefined HKEY_* 常量 .

index 是要检索的键索引标识整数。

The function retrieves the name of one subkey each time it is called. It is typically called repeatedly until a WindowsError 异常被引发，指示没有更多可用值。

_winreg. EnumValue ( key , index ) ¶

枚举打开注册表键的值，返回元组。

key is an already open key, or any one of the predefined HKEY_* 常量 .

index 是要检索的值索引标识整数。

The function retrieves the name of one subkey each time it is called. It is typically called repeatedly, until a WindowsError 异常被引发，指示没有更多值。

结果是 3 项元组：

索引	含义
0	标识值名称的字符串
1	保持值数据的对象，且其类型取决于底层注册表类型
2	标识值数据类型的整数 (见文档表格为 SetValueEx() )

_winreg. ExpandEnvironmentStrings ( unicode ) ¶

展开环境变量占位符 %NAME% in unicode strings like REG_EXPAND_SZ :

>>> ExpandEnvironmentStrings(u"%windir%")
u"C:\\Windows"
						

2.6 版新增。

_winreg. FlushKey ( key ) ¶

把键的所有属性写入注册表。

key 是已打开键，或某一预定义 HKEY_* 常量 .

它不必调用 FlushKey() 以改变键。注册表使用其惰性刷新器将注册表改变刷新到磁盘。注册表改变也被刷新到磁盘，在系统关闭时。不像 CloseKey() ， FlushKey() 方法才返回仅当所有数据已写入注册表时。应用程序只应调用 FlushKey() 若它要求绝对确定注册表改变是在磁盘中。

注意

若不知道是否 FlushKey() 调用是必需的，它可能不是必需的。

_winreg. LoadKey ( key , sub_key , file_name ) ¶

在指定键下创建子键，并把注册信息从指定文件存储到该子键。

key 是返回句柄通过 ConnectRegistry() 或某一常量对于 HKEY_USERS or HKEY_LOCAL_MACHINE .

sub_key 是要加载的子键标识字符串。

file_name 是要从中加载注册表数据的文件名。此文件必须被创建采用 SaveKey() 函数。在 FAT (文件分配表) 文件系统中，文件名可能没有扩展名。

调用 LoadKey() 失败若调用进程不拥有 SE_RESTORE_PRIVILEGE 特权。注意：特权不同于权限 – 见 RegLoadKey 文档编制 了解更多细节。

若 key 是返回句柄通过 ConnectRegistry() ，那么指定路径在 file_name 相对远程计算机。

_winreg. OpenKey ( key , sub_key [ , res [ , sam ] ] ) ¶

打开指定键，返回 句柄对象 .

key is an already open key, or any one of the predefined HKEY_* 常量 .

sub_key 是要打开的 sub_key 的标识字符串。

res 是预留整数，且必须为 0。默认 0。

sam 是指定访问掩码 (描述键期望的安全访问) 的整数。默认为 KEY_READ 。见 访问权 了解其它允许值。

结果是指定键的新句柄。

若函数失败， WindowsError 被引发。

_winreg. OpenKeyEx ( ) ¶

The functionality of OpenKeyEx() is provided via OpenKey() , by the use of default arguments.

_winreg. QueryInfoKey ( key ) ¶

以元组形式返回有关键的信息。

key 是已打开键，或某一预定义 HKEY_* 常量 .

结果是 3 项元组：

索引	含义
0	给出此键拥有的子键数的整数。
1	给出此键拥有值数量的整数。
2	A long integer giving when the key was last modified (if available) as 100’s of nanoseconds since Jan 1, 1601.

_winreg. QueryValue ( key , sub_key ) ¶

以字符串形式检索键的未命名值。

key 是已打开键，或某一预定义 HKEY_* 常量 .

sub_key 是保持关联值子键名称的字符串。若此参数为 None 或空，函数检索值的设置通过 SetValue() 方法为键标识通过 key .

注册表中的值拥有名称、类型及数据组件。此方法检索拥有 NULL 名称的键的首个值的数据。但底层 API 调用不返回类型，因此总是使用 QueryValueEx() 若可能的话。

_winreg. QueryValueEx ( key , value_name ) ¶

检索关联打开注册表键的指定值名称的类型和数据。

key 是已打开键，或某一预定义 HKEY_* 常量 .

value_name 是指示要查询值的字符串。

结果是 2 项元组：

索引	含义
0	注册表项的值。
1	给出此值的注册表类型的整数 (见文档表格为 SetValueEx() )

_winreg. SaveKey ( key , file_name ) ¶

把指定键及其所有子键保存到指定文件中。

key 是已打开键，或某一预定义 HKEY_* 常量 .

file_name 是要保存注册表数据的文件名。文件不能已存在。若文件名包含扩展名，它不能用于 FAT (文件分配表) 文件系统中通过 LoadKey() 方法。

若 key 表示远程计算机中的键，路径供述通过 file_name 相对远程计算机。此方法的调用者必须具备 SeBackupPrivilege 安全特权。注意：特权不同于权限 – 见 用户权利和权限之间冲突的文档编制 了解更多细节。

此函数传递 NULL 为 security_attributes 到 API。

_winreg. SetValue ( key , sub_key , type , 值 ) ¶

把值与指定键关联。

key 是已打开键，或某一预定义 HKEY_* 常量 .

sub_key 是关联值的子键的名称字符串。

type 是指定数据类型的整数。目前这必须是 REG_SZ ，意味着只支持字符串。使用 SetValueEx() 函数为支持其它数据类型。

value 是指定新值的字符串。

如果键指定通过 sub_key 参数不存在，SetValue 函数会创建它。

值长度受限于可用内存。长值 (超过 2048 字节) 应采用存储于配置注册表中的文件名按文件存储。这有助于注册表高效履行。

键标识通过 key 参数必须已打开采用 KEY_SET_VALUE 访问。

_winreg. SetValueEx ( key , value_name , reserved , type , 值 ) ¶

把数据存储在打开注册表键的值字段中。

key 是已打开键，或某一预定义 HKEY_* 常量 .

value_name 是关联值的子键的名称字符串。

type 是指定数据类型的整数。见 值类型 了解可用类型。

reserved 可以是任何值 – 始终把零传递给 API。

value 是指定新值的字符串。

此方法还可以为指定键设置额外的值和类型信息。键标识通过 key 参数必须已打开采用 KEY_SET_VALUE 访问。

要打开键，使用 CreateKey() or OpenKey() 方法。

值长度受限于可用内存。长值 (超过 2048 字节) 应采用存储于配置注册表中的文件名按文件存储。这有助于注册表高效履行。

_winreg. DisableReflectionKey ( key ) ¶

禁用 64 位操作系统运行 32 位进程注册表反射。

key 是已打开键，或某一预定义 HKEY_* 常量 .

一般来说会引发 NotImplementedError 若执行在 32 位操作系统。

若键不在反射列表中，函数会成功但没有效果。禁用键的反射不会影响任何子键的反射。

_winreg. EnableReflectionKey ( key ) ¶

还原指定禁用键的注册表反射。

key 是已打开键，或某一预定义 HKEY_* 常量 .

一般来说会引发 NotImplementedError 若执行在 32 位操作系统。

还原键的反射不会影响任何子键的反射。

_winreg. QueryReflectionKey ( key ) ¶

确定指定键的反射状态。

key 是已打开键，或某一预定义 HKEY_* 常量 .

返回 True 若反射被禁用。

一般来说会引发 NotImplementedError 若执行在 32 位操作系统。

35.3.1. 常量 ¶

以下定义常量可用于许多 _winreg 函数。

35.3.1.1. HKEY_* 常量 ¶

_winreg. HKEY_CLASSES_ROOT ¶

隶属此键的注册表条目定义文档类型 (或类) 及关联这些类型的特性。Shell 和 COM 应用程序使用存储于此键下的信息。

_winreg. HKEY_CURRENT_USER ¶

隶属此键的注册表条目定义当前用户首选项。这些首选项包括：环境变量设置、有关程序组的数据、颜色、打印机、网络连接及应用程序首选项。

_winreg. HKEY_LOCAL_MACHINE ¶

隶属此键的注册表条目定义计算机的物理状态，包括总线类型、系统内存、安装硬件及软件的有关数据。

_winreg. HKEY_USERS ¶

隶属此键的注册表条目定义本地计算机中新用户的默认用户配置和当前用户的用户配置。

_winreg. HKEY_PERFORMANCE_DATA ¶

隶属此键的注册表条目允许您访问性能数据。数据实际上并未存储在注册表中；注册表功能促使系统从它的来源采集数据。

_winreg. HKEY_CURRENT_CONFIG ¶

包含本地计算机系统当前硬件配置文件的有关信息。

_winreg. HKEY_DYN_DATA ¶

此键在 Windows 98 之后的 Windows 版本中不再使用。

35.3.1.2. 访问权 ¶

更多信息，见 注册表键安全性和访问 .

_winreg. KEY_ALL_ACCESS ¶

组合 STANDARD_RIGHTS_REQUIRED， KEY_QUERY_VALUE , KEY_SET_VALUE , KEY_CREATE_SUB_KEY , KEY_ENUMERATE_SUB_KEYS , KEY_NOTIFY ，和 KEY_CREATE_LINK 访问权。

_winreg. KEY_WRITE ¶

组合 STANDARD_RIGHTS_WRITE， KEY_SET_VALUE ，和 KEY_CREATE_SUB_KEY 访问权。

_winreg. KEY_READ ¶

结合 STANDARD_RIGHTS_READ， KEY_QUERY_VALUE , KEY_ENUMERATE_SUB_KEYS ，和 KEY_NOTIFY 值。

_winreg. KEY_EXECUTE ¶

相当于 KEY_READ .

_winreg. KEY_QUERY_VALUE ¶

要求查询注册表键的值。

_winreg. KEY_SET_VALUE ¶

要求创建、删除或设置注册表值。

_winreg. KEY_CREATE_SUB_KEY ¶

要求创建注册表键的子键。

_winreg. KEY_ENUMERATE_SUB_KEYS ¶

要求枚举注册表键的子键。

_winreg. KEY_NOTIFY ¶

要求请求改变注册表键 (或注册表键的子键) 的通知。

_winreg. KEY_CREATE_LINK ¶

预留给系统使用。

if handle:
    print "Yes"