winreg — Windows 注册表访问


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

3.3 版改变: 此模块中的几个函数被用于引发 WindowsError ,现在是别名化的 OSError .

函数

此模块提供下列函数:

winreg. CloseKey ( hkey )

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

注意

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

winreg. ConnectRegistry ( computer_name , key )

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

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

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

返回值是打开键的句柄。若函数失败, OSError 异常被引发。

引发 审计事件 winreg.ConnectRegistry 采用自变量 computer_name , key .

3.3 版改变: above .