Gecko [ fernandoquevedodop.com ]

Name	Size	Permission
2to3.html	70.96 KB	-rw-r--r--
__future__.html	20.75 KB	-rw-r--r--
__main__.html	44.87 KB	-rw-r--r--
_thread.html	30.39 KB	-rw-r--r--
abc.html	46.87 KB	-rw-r--r--
aifc.html	35.56 KB	-rw-r--r--
allos.html	34.33 KB	-rw-r--r--
archiving.html	17 KB	-rw-r--r--
argparse.html	300.89 KB	-rw-r--r--
array.html	37.28 KB	-rw-r--r--
ast.html	293.08 KB	-rw-r--r--
asynchat.html	37.41 KB	-rw-r--r--
asyncio-api-index.html	27.68 KB	-rw-r--r--
asyncio-dev.html	36.1 KB	-rw-r--r--
asyncio-eventloop.html	204.43 KB	-rw-r--r--
asyncio-exceptions.html	17.11 KB	-rw-r--r--
asyncio-future.html	38.23 KB	-rw-r--r--
asyncio-llapi-index.html	61.97 KB	-rw-r--r--
asyncio-platforms.html	21.77 KB	-rw-r--r--
asyncio-policy.html	39.56 KB	-rw-r--r--
asyncio-protocol.html	118.33 KB	-rw-r--r--
asyncio-queue.html	31.86 KB	-rw-r--r--
asyncio-stream.html	69.98 KB	-rw-r--r--
asyncio-subprocess.html	49.25 KB	-rw-r--r--
asyncio-sync.html	42.79 KB	-rw-r--r--
asyncio-task.html	109.14 KB	-rw-r--r--
asyncio.html	17.31 KB	-rw-r--r--
asyncore.html	49.36 KB	-rw-r--r--
atexit.html	22.87 KB	-rw-r--r--
audioop.html	46 KB	-rw-r--r--
audit_events.html	72.85 KB	-rw-r--r--
base64.html	48.09 KB	-rw-r--r--
bdb.html	66 KB	-rw-r--r--
binary.html	15.97 KB	-rw-r--r--
binascii.html	36.3 KB	-rw-r--r--
binhex.html	15.97 KB	-rw-r--r--
bisect.html	43.38 KB	-rw-r--r--
builtins.html	14.87 KB	-rw-r--r--
bz2.html	50.68 KB	-rw-r--r--
calendar.html	69.35 KB	-rw-r--r--
cgi.html	59.95 KB	-rw-r--r--
cgitb.html	19.96 KB	-rw-r--r--
chunk.html	22.21 KB	-rw-r--r--
cmath.html	43.89 KB	-rw-r--r--
cmd.html	50.42 KB	-rw-r--r--
code.html	35.38 KB	-rw-r--r--
codecs.html	157.96 KB	-rw-r--r--
codeop.html	18.26 KB	-rw-r--r--
collections.abc.html	79.17 KB	-rw-r--r--
collections.html	189.43 KB	-rw-r--r--
colorsys.html	17.31 KB	-rw-r--r--
compileall.html	50.68 KB	-rw-r--r--
concurrency.html	24.15 KB	-rw-r--r--
concurrent.futures.html	79.03 KB	-rw-r--r--
concurrent.html	11.56 KB	-rw-r--r--
configparser.html	159.4 KB	-rw-r--r--
constants.html	22.41 KB	-rw-r--r--
contextlib.html	117.2 KB	-rw-r--r--
contextvars.html	38.38 KB	-rw-r--r--
copy.html	17.92 KB	-rw-r--r--
copyreg.html	18.63 KB	-rw-r--r--
crypt.html	28.29 KB	-rw-r--r--
crypto.html	13.93 KB	-rw-r--r--
csv.html	82.89 KB	-rw-r--r--
ctypes.html	295.49 KB	-rw-r--r--
curses.ascii.html	32.04 KB	-rw-r--r--
curses.html	221.24 KB	-rw-r--r--
curses.panel.html	22.16 KB	-rw-r--r--
custominterp.html	11.85 KB	-rw-r--r--
dataclasses.html	113.16 KB	-rw-r--r--
datatypes.html	31.82 KB	-rw-r--r--
datetime.html	374.92 KB	-rw-r--r--
dbm.html	51.16 KB	-rw-r--r--
debug.html	17 KB	-rw-r--r--
decimal.html	270.12 KB	-rw-r--r--
development.html	32.34 KB	-rw-r--r--
devmode.html	31.72 KB	-rw-r--r--
dialog.html	43.03 KB	-rw-r--r--
difflib.html	111.99 KB	-rw-r--r--
dis.html	136.07 KB	-rw-r--r--
distribution.html	13.67 KB	-rw-r--r--
distutils.html	14.73 KB	-rw-r--r--
doctest.html	199.32 KB	-rw-r--r--
email.charset.html	31.92 KB	-rw-r--r--
email.compat32-message.html	97.74 KB	-rw-r--r--
email.contentmanager.html	37.02 KB	-rw-r--r--
email.encoders.html	18.47 KB	-rw-r--r--
email.errors.html	24.45 KB	-rw-r--r--
email.examples.html	60.49 KB	-rw-r--r--
email.generator.html	48.79 KB	-rw-r--r--
email.header.html	37.61 KB	-rw-r--r--
email.headerregistry.html	66.26 KB	-rw-r--r--
email.html	30.75 KB	-rw-r--r--
email.iterators.html	18.23 KB	-rw-r--r--
email.message.html	99.75 KB	-rw-r--r--
email.mime.html	44.89 KB	-rw-r--r--
email.parser.html	57.39 KB	-rw-r--r--
email.policy.html	84.24 KB	-rw-r--r--
email.utils.html	42.57 KB	-rw-r--r--
ensurepip.html	23.9 KB	-rw-r--r--
enum.html	151 KB	-rw-r--r--
errno.html	60.17 KB	-rw-r--r--
exceptions.html	108.44 KB	-rw-r--r--
faulthandler.html	31.5 KB	-rw-r--r--
fcntl.html	36.67 KB	-rw-r--r--
filecmp.html	32.08 KB	-rw-r--r--
fileformats.html	13.52 KB	-rw-r--r--
fileinput.html	40.37 KB	-rw-r--r--
filesys.html	16.78 KB	-rw-r--r--
fnmatch.html	21.02 KB	-rw-r--r--
fractions.html	35.29 KB	-rw-r--r--
frameworks.html	16.15 KB	-rw-r--r--
ftplib.html	71.97 KB	-rw-r--r--
functional.html	12.19 KB	-rw-r--r--
functions.html	260.33 KB	-rw-r--r--
functools.html	92.96 KB	-rw-r--r--
gc.html	40.97 KB	-rw-r--r--
getopt.html	29.4 KB	-rw-r--r--
getpass.html	16.01 KB	-rw-r--r--
gettext.html	98.02 KB	-rw-r--r--
glob.html	27.2 KB	-rw-r--r--
graphlib.html	34.82 KB	-rw-r--r--
grp.html	16.03 KB	-rw-r--r--
gzip.html	45.65 KB	-rw-r--r--
hashlib.html	93.19 KB	-rw-r--r--
heapq.html	42.43 KB	-rw-r--r--
hmac.html	24.74 KB	-rw-r--r--
html.entities.html	14.91 KB	-rw-r--r--
html.html	14.81 KB	-rw-r--r--
html.parser.html	47.7 KB	-rw-r--r--
http.client.html	85.63 KB	-rw-r--r--
http.cookiejar.html	113.94 KB	-rw-r--r--
http.cookies.html	47.64 KB	-rw-r--r--
http.html	45.52 KB	-rw-r--r--
http.server.html	73.05 KB	-rw-r--r--
i18n.html	13.44 KB	-rw-r--r--
idle.html	77.18 KB	-rw-r--r--
imaplib.html	87.08 KB	-rw-r--r--
imghdr.html	17.94 KB	-rw-r--r--
imp.html	54.32 KB	-rw-r--r--
importlib.html	239.96 KB	-rw-r--r--
importlib.metadata.html	43.14 KB	-rw-r--r--
index.html	75.06 KB	-rw-r--r--
inspect.html	168.74 KB	-rw-r--r--
internet.html	29.89 KB	-rw-r--r--
intro.html	13.81 KB	-rw-r--r--
io.html	154.15 KB	-rw-r--r--
ipaddress.html	137.75 KB	-rw-r--r--
ipc.html	12.6 KB	-rw-r--r--
itertools.html	153.27 KB	-rw-r--r--
json.html	98.9 KB	-rw-r--r--
keyword.html	14.88 KB	-rw-r--r--
language.html	16.71 KB	-rw-r--r--
linecache.html	18.09 KB	-rw-r--r--
locale.html	77.35 KB	-rw-r--r--
logging.config.html	100.3 KB	-rw-r--r--
logging.handlers.html	146.28 KB	-rw-r--r--
logging.html	169.67 KB	-rw-r--r--
lzma.html	66.89 KB	-rw-r--r--
mailbox.html	176.34 KB	-rw-r--r--
mailcap.html	20.86 KB	-rw-r--r--
markup.html	22.31 KB	-rw-r--r--
marshal.html	24.43 KB	-rw-r--r--
math.html	85.82 KB	-rw-r--r--
mimetypes.html	40.27 KB	-rw-r--r--
mm.html	11.16 KB	-rw-r--r--
mmap.html	55.53 KB	-rw-r--r--
modulefinder.html	23.67 KB	-rw-r--r--
modules.html	15.88 KB	-rw-r--r--
msilib.html	78.38 KB	-rw-r--r--
msvcrt.html	29.22 KB	-rw-r--r--
multiprocessing.html	405.24 KB	-rw-r--r--
multiprocessing.shared_memory....	60 KB	-rw-r--r--
netdata.html	20.24 KB	-rw-r--r--
netrc.html	20.39 KB	-rw-r--r--
nis.html	16.76 KB	-rw-r--r--
nntplib.html	84.93 KB	-rw-r--r--
numbers.html	45.67 KB	-rw-r--r--
numeric.html	19.29 KB	-rw-r--r--
operator.html	107.32 KB	-rw-r--r--
optparse.html	256.96 KB	-rw-r--r--
os.html	594.39 KB	-rw-r--r--
os.path.html	65.54 KB	-rw-r--r--
ossaudiodev.html	56.35 KB	-rw-r--r--
pathlib.html	170.01 KB	-rw-r--r--
pdb.html	68.67 KB	-rw-r--r--
persistence.html	19.13 KB	-rw-r--r--
pickle.html	154.45 KB	-rw-r--r--
pickletools.html	22.92 KB	-rw-r--r--
pipes.html	21.7 KB	-rw-r--r--
pkgutil.html	42.76 KB	-rw-r--r--
platform.html	45.08 KB	-rw-r--r--
plistlib.html	30.06 KB	-rw-r--r--
poplib.html	41.42 KB	-rw-r--r--
posix.html	20.96 KB	-rw-r--r--
pprint.html	55.35 KB	-rw-r--r--
profile.html	84.63 KB	-rw-r--r--
pty.html	23.7 KB	-rw-r--r--
pwd.html	16.84 KB	-rw-r--r--
py_compile.html	29 KB	-rw-r--r--
pyclbr.html	24.06 KB	-rw-r--r--
pydoc.html	19.59 KB	-rw-r--r--
pyexpat.html	104.38 KB	-rw-r--r--
python.html	22.46 KB	-rw-r--r--
queue.html	43.39 KB	-rw-r--r--
quopri.html	18.64 KB	-rw-r--r--
random.html	86.31 KB	-rw-r--r--
re.html	214.24 KB	-rw-r--r--
readline.html	50.19 KB	-rw-r--r--
reprlib.html	30.85 KB	-rw-r--r--
resource.html	48.26 KB	-rw-r--r--
rlcompleter.html	18.06 KB	-rw-r--r--
runpy.html	30.99 KB	-rw-r--r--
sched.html	27.04 KB	-rw-r--r--
secrets.html	30.2 KB	-rw-r--r--
security_warnings.html	16.21 KB	-rw-r--r--
select.html	74.58 KB	-rw-r--r--
selectors.html	41.91 KB	-rw-r--r--
shelve.html	36.54 KB	-rw-r--r--
shlex.html	61.03 KB	-rw-r--r--
shutil.html	100.13 KB	-rw-r--r--
signal.html	95.39 KB	-rw-r--r--
site.html	38.16 KB	-rw-r--r--
smtpd.html	44.09 KB	-rw-r--r--
smtplib.html	81.4 KB	-rw-r--r--
sndhdr.html	16.4 KB	-rw-r--r--
socket.html	256.95 KB	-rw-r--r--
socketserver.html	91.95 KB	-rw-r--r--
spwd.html	16.71 KB	-rw-r--r--
sqlite3.html	225.51 KB	-rw-r--r--
ssl.html	328.83 KB	-rw-r--r--
stat.html	57.79 KB	-rw-r--r--
statistics.html	123.22 KB	-rw-r--r--
stdtypes.html	615.43 KB	-rw-r--r--
string.html	108.03 KB	-rw-r--r--
stringprep.html	24.94 KB	-rw-r--r--
struct.html	70.58 KB	-rw-r--r--
subprocess.html	199.03 KB	-rw-r--r--
sunau.html	39.84 KB	-rw-r--r--
superseded.html	26.21 KB	-rw-r--r--
symtable.html	33.26 KB	-rw-r--r--
sys.html	198.83 KB	-rw-r--r--
sysconfig.html	39.81 KB	-rw-r--r--
syslog.html	27.36 KB	-rw-r--r--
tabnanny.html	16.18 KB	-rw-r--r--
tarfile.html	161.92 KB	-rw-r--r--
telnetlib.html	38.21 KB	-rw-r--r--
tempfile.html	58.39 KB	-rw-r--r--
termios.html	22.86 KB	-rw-r--r--
test.html	222.85 KB	-rw-r--r--
text.html	16.8 KB	-rw-r--r--
textwrap.html	48.83 KB	-rw-r--r--
threading.html	128.33 KB	-rw-r--r--
time.html	107.46 KB	-rw-r--r--
timeit.html	52.63 KB	-rw-r--r--
tk.html	28.08 KB	-rw-r--r--
tkinter.colorchooser.html	14.49 KB	-rw-r--r--
tkinter.dnd.html	17.09 KB	-rw-r--r--
tkinter.font.html	22.21 KB	-rw-r--r--
tkinter.html	106.85 KB	-rw-r--r--
tkinter.messagebox.html	20.09 KB	-rw-r--r--
tkinter.scrolledtext.html	14.52 KB	-rw-r--r--
tkinter.tix.html	59.69 KB	-rw-r--r--
tkinter.ttk.html	138.37 KB	-rw-r--r--
token.html	45.73 KB	-rw-r--r--
tokenize.html	39.86 KB	-rw-r--r--
trace.html	38.85 KB	-rw-r--r--
traceback.html	75.61 KB	-rw-r--r--
tracemalloc.html	122.33 KB	-rw-r--r--
tty.html	14.46 KB	-rw-r--r--
turtle.html	271.71 KB	-rw-r--r--
types.html	64.85 KB	-rw-r--r--
typing.html	315.69 KB	-rw-r--r--
unicodedata.html	27.3 KB	-rw-r--r--
unittest.html	310.01 KB	-rw-r--r--
unittest.mock-examples.html	177.75 KB	-rw-r--r--
unittest.mock.html	363.51 KB	-rw-r--r--
unix.html	13.46 KB	-rw-r--r--
urllib.error.html	18.56 KB	-rw-r--r--
urllib.html	12.92 KB	-rw-r--r--
urllib.parse.html	104.65 KB	-rw-r--r--
urllib.request.html	208.87 KB	-rw-r--r--
urllib.robotparser.html	22.63 KB	-rw-r--r--
uu.html	18.2 KB	-rw-r--r--
uuid.html	42.88 KB	-rw-r--r--
venv.html	90.43 KB	-rw-r--r--
warnings.html	69.13 KB	-rw-r--r--
wave.html	36.12 KB	-rw-r--r--
weakref.html	73.36 KB	-rw-r--r--
webbrowser.html	33.98 KB	-rw-r--r--
windows.html	12.32 KB	-rw-r--r--
winreg.html	89.48 KB	-rw-r--r--
winsound.html	26.3 KB	-rw-r--r--
wsgiref.html	111.52 KB	-rw-r--r--
xdrlib.html	42.07 KB	-rw-r--r--
xml.dom.html	114.66 KB	-rw-r--r--
xml.dom.minidom.html	49.6 KB	-rw-r--r--
xml.dom.pulldom.html	30.06 KB	-rw-r--r--
xml.etree.elementtree.html	186.49 KB	-rw-r--r--
xml.html	22.34 KB	-rw-r--r--
xml.sax.handler.html	55.78 KB	-rw-r--r--
xml.sax.html	31.74 KB	-rw-r--r--
xml.sax.reader.html	56.23 KB	-rw-r--r--
xml.sax.utils.html	22.28 KB	-rw-r--r--
xmlrpc.client.html	79.73 KB	-rw-r--r--
xmlrpc.html	11.9 KB	-rw-r--r--
xmlrpc.server.html	63.56 KB	-rw-r--r--
zipapp.html	52.45 KB	-rw-r--r--
zipfile.html	116.59 KB	-rw-r--r--
zipimport.html	33.76 KB	-rw-r--r--
zlib.html	42.29 KB	-rw-r--r--
zoneinfo.html	57.25 KB	-rw-r--r--

Code Editor : winreg.html

<!DOCTYPE html>

<title>winreg — Windows registry access &#8212; Python 3.10.12 documentation</title><meta name="viewport" content="width=device-width, initial-scale=1.0">
 
 <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
 <link rel="stylesheet" type="text/css" href="../_static/pydoctheme.css?2022.1" />
 
 <script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js"></script>
 <script src="../_static/jquery.js"></script>
 <script src="../_static/underscore.js"></script>
 <script src="../_static/doctools.js"></script>
 
 <script src="../_static/sidebar.js"></script>
 
 <link rel="search" type="application/opensearchdescription+xml"
 title="Search within Python 3.10.12 documentation"
 href="../_static/opensearch.xml"/>
 <link rel="author" title="About these documents" href="../about.html" />
 <link rel="index" title="Index" href="../genindex.html" />
 <link rel="search" title="Search" href="../search.html" />
 <link rel="copyright" title="Copyright" href="../copyright.html" />
 <link rel="next" title="winsound — Sound-playing interface for Windows" href="winsound.html" />
 <link rel="prev" title="msvcrt — Useful routines from the MS VC++ runtime" href="msvcrt.html" />
 <link rel="canonical" href="file:///usr/share/doc/python3.10/html/library/winreg.html" />

</head>
<body>
<div class="mobile-nav">
 <input type="checkbox" id="menuToggler" class="toggler__input" aria-controls="navigation"
 aria-pressed="false" aria-expanded="false" role="button" aria-label="Menu" />
 <label for="menuToggler" class="toggler__label">
 
 </label>
 <nav class="nav-content" role="navigation">
 <a href="https://www.python.org/" class="nav-logo">
 <img src="../_static/py.svg" alt="Logo"/>
 </a>
 <div class="version_switcher_placeholder"></div>
 <form role="search" class="search" action="../search.html" method="get">
 <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" class="search-icon">
 <path fill-rule="nonzero"
 d="M15.5 14h-.79l-.28-.27a6.5 6.5 0 001.48-5.34c-.47-2.78-2.79-5-5.59-5.34a6.505 6.505 0 00-7.27 7.27c.34 2.8 2.56 5.12 5.34 5.59a6.5 6.5 0 005.34-1.48l.27.28v.79l4.25 4.25c.41.41 1.08.41 1.49 0 .41-.41.41-1.08 0-1.49L15.5 14zm-6 0C7.01 14 5 11.99 5 9.5S7.01 5 9.5 5 14 7.01 14 9.5 11.99 14 9.5 14z" fill="#444"></path>
 </svg>
 <input type="text" name="q" aria-label="Quick search"/>
 <input type="submit" value="Go"/>
 </form>
 </nav>
 <div class="menu-wrapper">
 <nav class="menu" role="navigation" aria-label="main navigation">
 <div class="language_switcher_placeholder"></div>
 <h3><a href="../contents.html">Table of Contents</a></h3>
 <ul>
<li><a class="reference internal" href="#"><code class="xref py py-mod docutils literal notranslate">winreg</code> — Windows registry access</a><ul>
<li><a class="reference internal" href="#functions">Functions</a></li>
<li><a class="reference internal" href="#constants">Constants</a><ul>
<li><a class="reference internal" href="#hkey-constants">HKEY_* Constants</a></li>
<li><a class="reference internal" href="#access-rights">Access Rights</a><ul>
<li><a class="reference internal" href="#bit-specific">64-bit Specific</a></li>
</ul>
</li>
<li><a class="reference internal" href="#value-types">Value Types</a></li>
</ul>
</li>
<li><a class="reference internal" href="#registry-handle-objects">Registry Handle Objects</a></li>
</ul>
</li>
</ul>

<div class="related" role="navigation" aria-label="related navigation">
 <h3>Navigation</h3>
 <ul>
 <li class="right" style="margin-right: 10px">
 <a href="../genindex.html" title="General Index"
 accesskey="I">index</a></li>
 <li class="right" >
 <a href="../py-modindex.html" title="Python Module Index"
 >modules</a> |</li>
 <li class="right" >
 <a href="winsound.html" title="winsound — Sound-playing interface for Windows"
 accesskey="N">next</a> |</li>
 <li class="right" >
 <a href="msvcrt.html" title="msvcrt — Useful routines from the MS VC++ runtime"
 accesskey="P">previous</a> |</li>

<li><img src="../_static/py.svg" alt="python logo" style="vertical-align: middle; margin-top: -1px"/></li>
 <li><a href="https://www.python.org/">Python</a> &#187;</li>
 <li class="switchers">
 <div class="language_switcher_placeholder"></div>
 <div class="version_switcher_placeholder"></div>
 </li>
 <li>
 
 </li>
 <li id="cpython-language-and-version">
 <a href="../index.html">3.10.12 Documentation</a> &#187;
 </li>

<li class="nav-item nav-item-1"><a href="index.html" >The Python Standard Library</a> &#187;</li>
 <li class="nav-item nav-item-2"><a href="windows.html" accesskey="U">MS Windows Specific Services</a> &#187;</li>
 <li class="nav-item nav-item-this"><a href=""><code class="xref py py-mod docutils literal notranslate">winreg</code> — Windows registry access</a></li>
 <li class="right">

<div class="document">
 <div class="documentwrapper">
 <div class="bodywrapper">
 <div class="body" role="main">
 
 <section id="module-winreg">
<h1><a class="reference internal" href="#module-winreg" title="winreg: Routines and objects for manipulating the Windows registry. (Windows)"><code class="xref py py-mod docutils literal notranslate">winreg</code></a> — Windows registry access<a class="headerlink" href="#module-winreg" title="Permalink to this headline">¶</a></h1>
<hr class="docutils" />
These functions expose the Windows registry API to Python. Instead of using an
integer as the registry handle, a <a class="reference internal" href="#handle-object">handle object</a> is used
to ensure that the handles are closed correctly, even if the programmer neglects
to explicitly close them.
<div class="versionchanged" id="exception-changed">
Changed in version 3.3: Several functions in this module used to raise a
<a class="reference internal" href="exceptions.html#WindowsError" title="WindowsError"><code class="xref py py-exc docutils literal notranslate">WindowsError</code></a>, which is now an alias of <a class="reference internal" href="exceptions.html#OSError" title="OSError"><code class="xref py py-exc docutils literal notranslate">OSError</code></a>.
</div>
<section id="functions">
<h2>Functions<a class="headerlink" href="#functions" title="Permalink to this headline">¶</a></h2>
This module offers the following functions:
<dl class="py function">
<dt class="sig sig-object py" id="winreg.CloseKey">
winreg.CloseKey(hkey)<a class="headerlink" href="#winreg.CloseKey" title="Permalink to this definition">¶</a></dt>
<dd>Closes a previously opened registry key. The hkey argument specifies a
previously opened key.
<div class="admonition note">
Note
If hkey is not closed using this method (or via <a class="reference internal" href="#winreg.PyHKEY.Close" title="winreg.PyHKEY.Close"><code class="xref py py-meth docutils literal notranslate">hkey.Close()</code></a>), it is closed when the hkey object is destroyed by
Python.
</div>
</dd></dl>

<dl class="py function">
<dt class="sig sig-object py" id="winreg.ConnectRegistry">
winreg.ConnectRegistry(computer_name, key)<a class="headerlink" href="#winreg.ConnectRegistry" title="Permalink to this definition">¶</a></dt>
<dd>Establishes a connection to a predefined registry handle on another computer,
and returns a <a class="reference internal" href="#handle-object">handle object</a>.
computer_name is the name of the remote computer, of the form
<code class="docutils literal notranslate">r&quot;\\computername&quot;</code>. If <code class="docutils literal notranslate">None</code>, the local computer is used.
key is the predefined handle to connect to.
The return value is the handle of the opened key. If the function fails, an
<a class="reference internal" href="exceptions.html#OSError" title="OSError"><code class="xref py py-exc docutils literal notranslate">OSError</code></a> exception is raised.
Raises an <a class="reference internal" href="sys.html#auditing">auditing event</a> <code class="docutils literal notranslate">winreg.ConnectRegistry</code> with arguments <code class="docutils literal notranslate">computer_name</code>, <code class="docutils literal notranslate">key</code>.
<div class="versionchanged">
Changed in version 3.3: See <a class="reference internal" href="#exception-changed">above</a>.
</div>
</dd></dl>

<dl class="py function">
<dt class="sig sig-object py" id="winreg.CreateKey">
winreg.CreateKey(key, sub_key)<a class="headerlink" href="#winreg.CreateKey" title="Permalink to this definition">¶</a></dt>
<dd>Creates or opens the specified key, returning a
<a class="reference internal" href="#handle-object">handle object</a>.
key is an already open key, or one of the predefined
<a class="reference internal" href="#hkey-constants">HKEY_* constants</a>.
sub_key is a string that names the key this method opens or creates.
If key is one of the predefined keys, sub_key may be <code class="docutils literal notranslate">None</code>. In that
case, the handle returned is the same key handle passed in to the function.
If the key already exists, this function opens the existing key.
The return value is the handle of the opened key. If the function fails, an
<a class="reference internal" href="exceptions.html#OSError" title="OSError"><code class="xref py py-exc docutils literal notranslate">OSError</code></a> exception is raised.
Raises an <a class="reference internal" href="sys.html#auditing">auditing event</a> <code class="docutils literal notranslate">winreg.CreateKey</code> with arguments <code class="docutils literal notranslate">key</code>, <code class="docutils literal notranslate">sub_key</code>, <code class="docutils literal notranslate">access</code>.
Raises an <a class="reference internal" href="sys.html#auditing">auditing event</a> <code class="docutils literal notranslate">winreg.OpenKey/result</code> with argument <code class="docutils literal notranslate">key</code>.
<div class="versionchanged">
Changed in version 3.3: See <a class="reference internal" href="#exception-changed">above</a>.
</div>
</dd></dl>

<dl class="py function">
<dt class="sig sig-object py" id="winreg.CreateKeyEx">
winreg.CreateKeyEx(key, sub_key, reserved=0, access=KEY_WRITE)<a class="headerlink" href="#winreg.CreateKeyEx" title="Permalink to this definition">¶</a></dt>
<dd>Creates or opens the specified key, returning a
<a class="reference internal" href="#handle-object">handle object</a>.
key is an already open key, or one of the predefined
<a class="reference internal" href="#hkey-constants">HKEY_* constants</a>.
sub_key is a string that names the key this method opens or creates.
reserved is a reserved integer, and must be zero. The default is zero.
access is an integer that specifies an access mask that describes the desired
security access for the key. Default is <a class="reference internal" href="#winreg.KEY_WRITE" title="winreg.KEY_WRITE"><code class="xref py py-const docutils literal notranslate">KEY_WRITE</code></a>. See
<a class="reference internal" href="#access-rights">Access Rights</a> for other allowed values.
If key is one of the predefined keys, sub_key may be <code class="docutils literal notranslate">None</code>. In that
case, the handle returned is the same key handle passed in to the function.
If the key already exists, this function opens the existing key.
The return value is the handle of the opened key. If the function fails, an
<a class="reference internal" href="exceptions.html#OSError" title="OSError"><code class="xref py py-exc docutils literal notranslate">OSError</code></a> exception is raised.
Raises an <a class="reference internal" href="sys.html#auditing">auditing event</a> <code class="docutils literal notranslate">winreg.CreateKey</code> with arguments <code class="docutils literal notranslate">key</code>, <code class="docutils literal notranslate">sub_key</code>, <code class="docutils literal notranslate">access</code>.
Raises an <a class="reference internal" href="sys.html#auditing">auditing event</a> <code class="docutils literal notranslate">winreg.OpenKey/result</code> with argument <code class="docutils literal notranslate">key</code>.
<div class="versionadded">
New in version 3.2.
</div>
<div class="versionchanged">
Changed in version 3.3: See <a class="reference internal" href="#exception-changed">above</a>.
</div>
</dd></dl>

<dl class="py function">
<dt class="sig sig-object py" id="winreg.DeleteKey">
winreg.DeleteKey(key, sub_key)<a class="headerlink" href="#winreg.DeleteKey" title="Permalink to this definition">¶</a></dt>
<dd>Deletes the specified key.
key is an already open key, or one of the predefined
<a class="reference internal" href="#hkey-constants">HKEY_* constants</a>.
sub_key is a string that must be a subkey of the key identified by the key
parameter. This value must not be <code class="docutils literal notranslate">None</code>, and the key may not have subkeys.
This method can not delete keys with subkeys.
If the method succeeds, the entire key, including all of its values, is removed.
If the method fails, an <a class="reference internal" href="exceptions.html#OSError" title="OSError"><code class="xref py py-exc docutils literal notranslate">OSError</code></a> exception is raised.
Raises an <a class="reference internal" href="sys.html#auditing">auditing event</a> <code class="docutils literal notranslate">winreg.DeleteKey</code> with arguments <code class="docutils literal notranslate">key</code>, <code class="docutils literal notranslate">sub_key</code>, <code class="docutils literal notranslate">access</code>.
<div class="versionchanged">
Changed in version 3.3: See <a class="reference internal" href="#exception-changed">above</a>.
</div>
</dd></dl>

<dl class="py function">
<dt class="sig sig-object py" id="winreg.DeleteKeyEx">
winreg.DeleteKeyEx(key, sub_key, access=KEY_WOW64_64KEY, reserved=0)<a class="headerlink" href="#winreg.DeleteKeyEx" title="Permalink to this definition">¶</a></dt>
<dd>Deletes the specified key.
key is an already open key, or one of the predefined
<a class="reference internal" href="#hkey-constants">HKEY_* constants</a>.
sub_key is a string that must be a subkey of the key identified by the
key parameter. This value must not be <code class="docutils literal notranslate">None</code>, and the key may not have
subkeys.
reserved is a reserved integer, and must be zero. The default is zero.
access is an integer that specifies an access mask that describes the
desired security access for the key. Default is <a class="reference internal" href="#winreg.KEY_WOW64_64KEY" title="winreg.KEY_WOW64_64KEY"><code class="xref py py-const docutils literal notranslate">KEY_WOW64_64KEY</code></a>.
On 32-bit Windows, the WOW64 constants are ignored.
See <a class="reference internal" href="#access-rights">Access Rights</a> for other allowed values.
This method can not delete keys with subkeys.
If the method succeeds, the entire key, including all of its values, is
removed. If the method fails, an <a class="reference internal" href="exceptions.html#OSError" title="OSError"><code class="xref py py-exc docutils literal notranslate">OSError</code></a> exception is raised.
On unsupported Windows versions, <a class="reference internal" href="exceptions.html#NotImplementedError" title="NotImplementedError"><code class="xref py py-exc docutils literal notranslate">NotImplementedError</code></a> is raised.
Raises an <a class="reference internal" href="sys.html#auditing">auditing event</a> <code class="docutils literal notranslate">winreg.DeleteKey</code> with arguments <code class="docutils literal notranslate">key</code>, <code class="docutils literal notranslate">sub_key</code>, <code class="docutils literal notranslate">access</code>.
<div class="versionadded">
New in version 3.2.
</div>
<div class="versionchanged">
Changed in version 3.3: See <a class="reference internal" href="#exception-changed">above</a>.
</div>
</dd></dl>

<dl class="py function">
<dt class="sig sig-object py" id="winreg.DeleteValue">
winreg.DeleteValue(key, value)<a class="headerlink" href="#winreg.DeleteValue" title="Permalink to this definition">¶</a></dt>
<dd>Removes a named value from a registry key.
key is an already open key, or one of the predefined
<a class="reference internal" href="#hkey-constants">HKEY_* constants</a>.
value is a string that identifies the value to remove.
Raises an <a class="reference internal" href="sys.html#auditing">auditing event</a> <code class="docutils literal notranslate">winreg.DeleteValue</code> with arguments <code class="docutils literal notranslate">key</code>, <code class="docutils literal notranslate">value</code>.
</dd></dl>

<dl class="py function">
<dt class="sig sig-object py" id="winreg.EnumKey">
winreg.EnumKey(key, index)<a class="headerlink" href="#winreg.EnumKey" title="Permalink to this definition">¶</a></dt>
<dd>Enumerates subkeys of an open registry key, returning a string.
key is an already open key, or one of the predefined
<a class="reference internal" href="#hkey-constants">HKEY_* constants</a>.
index is an integer that identifies the index of the key to retrieve.
The function retrieves the name of one subkey each time it is called. It is
typically called repeatedly until an <a class="reference internal" href="exceptions.html#OSError" title="OSError"><code class="xref py py-exc docutils literal notranslate">OSError</code></a> exception is
raised, indicating, no more values are available.
Raises an <a class="reference internal" href="sys.html#auditing">auditing event</a> <code class="docutils literal notranslate">winreg.EnumKey</code> with arguments <code class="docutils literal notranslate">key</code>, <code class="docutils literal notranslate">index</code>.
<div class="versionchanged">
Changed in version 3.3: See <a class="reference internal" href="#exception-changed">above</a>.
</div>
</dd></dl>

<dl class="py function">
<dt class="sig sig-object py" id="winreg.EnumValue">
winreg.EnumValue(key, index)<a class="headerlink" href="#winreg.EnumValue" title="Permalink to this definition">¶</a></dt>
<dd>Enumerates values of an open registry key, returning a tuple.
key is an already open key, or one of the predefined
<a class="reference internal" href="#hkey-constants">HKEY_* constants</a>.
index is an integer that identifies the index of the value to retrieve.
The function retrieves the name of one subkey each time it is called. It is
typically called repeatedly, until an <a class="reference internal" href="exceptions.html#OSError" title="OSError"><code class="xref py py-exc docutils literal notranslate">OSError</code></a> exception is
raised, indicating no more values.
The result is a tuple of 3 items:
<table class="docutils align-default">
<colgroup>
<col style="width: 14%" />
<col style="width: 86%" />
</colgroup>
<thead>
<tr class="row-odd"><th class="head">Index</th>
<th class="head">Meaning</th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><code class="docutils literal notranslate">0</code></td>
<td>A string that identifies the value name</td>
</tr>
<tr class="row-odd"><td><code class="docutils literal notranslate">1</code></td>
<td>An object that holds the value data, and
whose type depends on the underlying
registry type</td>
</tr>
<tr class="row-even"><td><code class="docutils literal notranslate">2</code></td>
<td>An integer that identifies the type of the
value data (see table in docs for
<a class="reference internal" href="#winreg.SetValueEx" title="winreg.SetValueEx"><code class="xref py py-meth docutils literal notranslate">SetValueEx()</code></a>)</td>
</tr>
</tbody>
</table>
Raises an <a class="reference internal" href="sys.html#auditing">auditing event</a> <code class="docutils literal notranslate">winreg.EnumValue</code> with arguments <code class="docutils literal notranslate">key</code>, <code class="docutils literal notranslate">index</code>.
<div class="versionchanged">
Changed in version 3.3: See <a class="reference internal" href="#exception-changed">above</a>.
</div>
</dd></dl>

<dl class="py function">
<dt class="sig sig-object py" id="winreg.ExpandEnvironmentStrings">
winreg.ExpandEnvironmentStrings(str)<a class="headerlink" href="#winreg.ExpandEnvironmentStrings" title="Permalink to this definition">¶</a></dt>
<dd>Expands environment variable placeholders <code class="docutils literal notranslate">%NAME%</code> in strings like
<a class="reference internal" href="#winreg.REG_EXPAND_SZ" title="winreg.REG_EXPAND_SZ"><code class="xref py py-const docutils literal notranslate">REG_EXPAND_SZ</code></a>:
<div class="highlight-python3 notranslate"><div class="highlight"><pre>&gt;&gt;&gt; ExpandEnvironmentStrings(&#39;%windir%&#39;)
&#39;C:\\Windows&#39;
</pre></div>
</div>
Raises an <a class="reference internal" href="sys.html#auditing">auditing event</a> <code class="docutils literal notranslate">winreg.ExpandEnvironmentStrings</code> with argument <code class="docutils literal notranslate">str</code>.
</dd></dl>

<dl class="py function">
<dt class="sig sig-object py" id="winreg.FlushKey">
winreg.FlushKey(key)<a class="headerlink" href="#winreg.FlushKey" title="Permalink to this definition">¶</a></dt>
<dd>Writes all the attributes of a key to the registry.
key is an already open key, or one of the predefined
<a class="reference internal" href="#hkey-constants">HKEY_* constants</a>.
It is not necessary to call <a class="reference internal" href="#winreg.FlushKey" title="winreg.FlushKey"><code class="xref py py-func docutils literal notranslate">FlushKey()</code></a> to change a key. Registry changes are
flushed to disk by the registry using its lazy flusher. Registry changes are
also flushed to disk at system shutdown. Unlike <a class="reference internal" href="#winreg.CloseKey" title="winreg.CloseKey"><code class="xref py py-func docutils literal notranslate">CloseKey()</code></a>, the
<a class="reference internal" href="#winreg.FlushKey" title="winreg.FlushKey"><code class="xref py py-func docutils literal notranslate">FlushKey()</code></a> method returns only when all the data has been written to the
registry. An application should only call <a class="reference internal" href="#winreg.FlushKey" title="winreg.FlushKey"><code class="xref py py-func docutils literal notranslate">FlushKey()</code></a> if it requires
absolute certainty that registry changes are on disk.
<div class="admonition note">
Note
If you don’t know whether a <a class="reference internal" href="#winreg.FlushKey" title="winreg.FlushKey"><code class="xref py py-func docutils literal notranslate">FlushKey()</code></a> call is required, it probably
isn’t.
</div>
</dd></dl>

<dl class="py function">
<dt class="sig sig-object py" id="winreg.LoadKey">
winreg.LoadKey(key, sub_key, file_name)<a class="headerlink" href="#winreg.LoadKey" title="Permalink to this definition">¶</a></dt>
<dd>Creates a subkey under the specified key and stores registration information
from a specified file into that subkey.
key is a handle returned by <a class="reference internal" href="#winreg.ConnectRegistry" title="winreg.ConnectRegistry"><code class="xref py py-func docutils literal notranslate">ConnectRegistry()</code></a> or one of the constants
<a class="reference internal" href="#winreg.HKEY_USERS" title="winreg.HKEY_USERS"><code class="xref py py-const docutils literal notranslate">HKEY_USERS</code></a> or <a class="reference internal" href="#winreg.HKEY_LOCAL_MACHINE" title="winreg.HKEY_LOCAL_MACHINE"><code class="xref py py-const docutils literal notranslate">HKEY_LOCAL_MACHINE</code></a>.
sub_key is a string that identifies the subkey to load.
file_name is the name of the file to load registry data from. This file must
have been created with the <a class="reference internal" href="#winreg.SaveKey" title="winreg.SaveKey"><code class="xref py py-func docutils literal notranslate">SaveKey()</code></a> function. Under the file allocation
table (FAT) file system, the filename may not have an extension.
A call to <a class="reference internal" href="#winreg.LoadKey" title="winreg.LoadKey"><code class="xref py py-func docutils literal notranslate">LoadKey()</code></a> fails if the calling process does not have the
<code class="xref py py-const docutils literal notranslate">SE_RESTORE_PRIVILEGE</code> privilege. Note that privileges are different
from permissions – see the <a class="reference external" href="https://msdn.microsoft.com/en-us/library/ms724889%28v=VS.85%29.aspx">RegLoadKey documentation</a> for
more details.
If key is a handle returned by <a class="reference internal" href="#winreg.ConnectRegistry" title="winreg.ConnectRegistry"><code class="xref py py-func docutils literal notranslate">ConnectRegistry()</code></a>, then the path
specified in file_name is relative to the remote computer.
Raises an <a class="reference internal" href="sys.html#auditing">auditing event</a> <code class="docutils literal notranslate">winreg.LoadKey</code> with arguments <code class="docutils literal notranslate">key</code>, <code class="docutils literal notranslate">sub_key</code>, <code class="docutils literal notranslate">file_name</code>.
</dd></dl>

<dl class="py function">
<dt class="sig sig-object py" id="winreg.OpenKey">
winreg.OpenKey(key, sub_key, reserved=0, access=KEY_READ)<a class="headerlink" href="#winreg.OpenKey" title="Permalink to this definition">¶</a></dt>
<dt class="sig sig-object py" id="winreg.OpenKeyEx">
winreg.OpenKeyEx(key, sub_key, reserved=0, access=KEY_READ)<a class="headerlink" href="#winreg.OpenKeyEx" title="Permalink to this definition">¶</a></dt>
<dd>Opens the specified key, returning a <a class="reference internal" href="#handle-object">handle object</a>.
key is an already open key, or one of the predefined
<a class="reference internal" href="#hkey-constants">HKEY_* constants</a>.
sub_key is a string that identifies the sub_key to open.
reserved is a reserved integer, and must be zero. The default is zero.
access is an integer that specifies an access mask that describes the desired
security access for the key. Default is <a class="reference internal" href="#winreg.KEY_READ" title="winreg.KEY_READ"><code class="xref py py-const docutils literal notranslate">KEY_READ</code></a>. See <a class="reference internal" href="#access-rights">Access
Rights</a> for other allowed values.
The result is a new handle to the specified key.
If the function fails, <a class="reference internal" href="exceptions.html#OSError" title="OSError"><code class="xref py py-exc docutils literal notranslate">OSError</code></a> is raised.
Raises an <a class="reference internal" href="sys.html#auditing">auditing event</a> <code class="docutils literal notranslate">winreg.OpenKey</code> with arguments <code class="docutils literal notranslate">key</code>, <code class="docutils literal notranslate">sub_key</code>, <code class="docutils literal notranslate">access</code>.
Raises an <a class="reference internal" href="sys.html#auditing">auditing event</a> <code class="docutils literal notranslate">winreg.OpenKey/result</code> with argument <code class="docutils literal notranslate">key</code>.
<div class="versionchanged">
Changed in version 3.2: Allow the use of named arguments.
</div>
<div class="versionchanged">
Changed in version 3.3: See <a class="reference internal" href="#exception-changed">above</a>.
</div>
</dd></dl>

<dl class="py function">
<dt class="sig sig-object py" id="winreg.QueryInfoKey">
winreg.QueryInfoKey(key)<a class="headerlink" href="#winreg.QueryInfoKey" title="Permalink to this definition">¶</a></dt>
<dd>Returns information about a key, as a tuple.
key is an already open key, or one of the predefined
<a class="reference internal" href="#hkey-constants">HKEY_* constants</a>.
The result is a tuple of 3 items:
<table class="docutils align-default">
<colgroup>
<col style="width: 13%" />
<col style="width: 87%" />
</colgroup>
<thead>
<tr class="row-odd"><th class="head">Index</th>
<th class="head">Meaning</th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><code class="docutils literal notranslate">0</code></td>
<td>An integer giving the number of sub keys
this key has.</td>
</tr>
<tr class="row-odd"><td><code class="docutils literal notranslate">1</code></td>
<td>An integer giving the number of values this
key has.</td>
</tr>
<tr class="row-even"><td><code class="docutils literal notranslate">2</code></td>
<td>An integer giving when the key was last
modified (if available) as 100’s of
nanoseconds since Jan 1, 1601.</td>
</tr>
</tbody>
</table>
Raises an <a class="reference internal" href="sys.html#auditing">auditing event</a> <code class="docutils literal notranslate">winreg.QueryInfoKey</code> with argument <code class="docutils literal notranslate">key</code>.
</dd></dl>

<dl class="py function">
<dt class="sig sig-object py" id="winreg.QueryValue">
winreg.QueryValue(key, sub_key)<a class="headerlink" href="#winreg.QueryValue" title="Permalink to this definition">¶</a></dt>
<dd>Retrieves the unnamed value for a key, as a string.
key is an already open key, or one of the predefined
<a class="reference internal" href="#hkey-constants">HKEY_* constants</a>.
sub_key is a string that holds the name of the subkey with which the value is
associated. If this parameter is <code class="docutils literal notranslate">None</code> or empty, the function retrieves the
value set by the <a class="reference internal" href="#winreg.SetValue" title="winreg.SetValue"><code class="xref py py-func docutils literal notranslate">SetValue()</code></a> method for the key identified by key.
Values in the registry have name, type, and data components. This method
retrieves the data for a key’s first value that has a <code class="docutils literal notranslate">NULL</code> name. But the
underlying API call doesn’t return the type, so always use
<a class="reference internal" href="#winreg.QueryValueEx" title="winreg.QueryValueEx"><code class="xref py py-func docutils literal notranslate">QueryValueEx()</code></a> if possible.
Raises an <a class="reference internal" href="sys.html#auditing">auditing event</a> <code class="docutils literal notranslate">winreg.QueryValue</code> with arguments <code class="docutils literal notranslate">key</code>, <code class="docutils literal notranslate">sub_key</code>, <code class="docutils literal notranslate">value_name</code>.
</dd></dl>

<dl class="py function">
<dt class="sig sig-object py" id="winreg.QueryValueEx">
winreg.QueryValueEx(key, value_name)<a class="headerlink" href="#winreg.QueryValueEx" title="Permalink to this definition">¶</a></dt>
<dd>Retrieves the type and data for a specified value name associated with
an open registry key.
key is an already open key, or one of the predefined
<a class="reference internal" href="#hkey-constants">HKEY_* constants</a>.
value_name is a string indicating the value to query.
The result is a tuple of 2 items:
<table class="docutils align-default">
<colgroup>
<col style="width: 15%" />
<col style="width: 85%" />
</colgroup>
<thead>
<tr class="row-odd"><th class="head">Index</th>
<th class="head">Meaning</th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><code class="docutils literal notranslate">0</code></td>
<td>The value of the registry item.</td>
</tr>
<tr class="row-odd"><td><code class="docutils literal notranslate">1</code></td>
<td>An integer giving the registry type for
this value (see table in docs for
<a class="reference internal" href="#winreg.SetValueEx" title="winreg.SetValueEx"><code class="xref py py-meth docutils literal notranslate">SetValueEx()</code></a>)</td>
</tr>
</tbody>
</table>
Raises an <a class="reference internal" href="sys.html#auditing">auditing event</a> <code class="docutils literal notranslate">winreg.QueryValue</code> with arguments <code class="docutils literal notranslate">key</code>, <code class="docutils literal notranslate">sub_key</code>, <code class="docutils literal notranslate">value_name</code>.
</dd></dl>

<dl class="py function">
<dt class="sig sig-object py" id="winreg.SaveKey">
winreg.SaveKey(key, file_name)<a class="headerlink" href="#winreg.SaveKey" title="Permalink to this definition">¶</a></dt>
<dd>Saves the specified key, and all its subkeys to the specified file.
key is an already open key, or one of the predefined
<a class="reference internal" href="#hkey-constants">HKEY_* constants</a>.
file_name is the name of the file to save registry data to. This file
cannot already exist. If this filename includes an extension, it cannot be
used on file allocation table (FAT) file systems by the <a class="reference internal" href="#winreg.LoadKey" title="winreg.LoadKey"><code class="xref py py-meth docutils literal notranslate">LoadKey()</code></a>
method.
If key represents a key on a remote computer, the path described by
file_name is relative to the remote computer. The caller of this method must
possess the <code class="xref py py-const docutils literal notranslate">SeBackupPrivilege</code> security privilege. Note that
privileges are different than permissions – see the
<a class="reference external" href="https://msdn.microsoft.com/en-us/library/ms724878%28v=VS.85%29.aspx">Conflicts Between User Rights and Permissions documentation</a>
for more details.
This function passes <code class="docutils literal notranslate">NULL</code> for security_attributes to the API.
Raises an <a class="reference internal" href="sys.html#auditing">auditing event</a> <code class="docutils literal notranslate">winreg.SaveKey</code> with arguments <code class="docutils literal notranslate">key</code>, <code class="docutils literal notranslate">file_name</code>.
</dd></dl>

<dl class="py function">
<dt class="sig sig-object py" id="winreg.SetValue">
winreg.SetValue(key, sub_key, type, value)<a class="headerlink" href="#winreg.SetValue" title="Permalink to this definition">¶</a></dt>
<dd>Associates a value with a specified key.
key is an already open key, or one of the predefined
<a class="reference internal" href="#hkey-constants">HKEY_* constants</a>.
sub_key is a string that names the subkey with which the value is associated.
type is an integer that specifies the type of the data. Currently this must be
<a class="reference internal" href="#winreg.REG_SZ" title="winreg.REG_SZ"><code class="xref py py-const docutils literal notranslate">REG_SZ</code></a>, meaning only strings are supported. Use the <a class="reference internal" href="#winreg.SetValueEx" title="winreg.SetValueEx"><code class="xref py py-func docutils literal notranslate">SetValueEx()</code></a>
function for support for other data types.
value is a string that specifies the new value.
If the key specified by the sub_key parameter does not exist, the SetValue
function creates it.
Value lengths are limited by available memory. Long values (more than 2048
bytes) should be stored as files with the filenames stored in the configuration
registry. This helps the registry perform efficiently.
The key identified by the key parameter must have been opened with
<a class="reference internal" href="#winreg.KEY_SET_VALUE" title="winreg.KEY_SET_VALUE"><code class="xref py py-const docutils literal notranslate">KEY_SET_VALUE</code></a> access.
Raises an <a class="reference internal" href="sys.html#auditing">auditing event</a> <code class="docutils literal notranslate">winreg.SetValue</code> with arguments <code class="docutils literal notranslate">key</code>, <code class="docutils literal notranslate">sub_key</code>, <code class="docutils literal notranslate">type</code>, <code class="docutils literal notranslate">value</code>.
</dd></dl>

<dl class="py function">
<dt class="sig sig-object py" id="winreg.SetValueEx">
winreg.SetValueEx(key, value_name, reserved, type, value)<a class="headerlink" href="#winreg.SetValueEx" title="Permalink to this definition">¶</a></dt>
<dd>Stores data in the value field of an open registry key.
key is an already open key, or one of the predefined
<a class="reference internal" href="#hkey-constants">HKEY_* constants</a>.
value_name is a string that names the subkey with which the value is
associated.
reserved can be anything – zero is always passed to the API.
type is an integer that specifies the type of the data. See
<a class="reference internal" href="#value-types">Value Types</a> for the available types.
value is a string that specifies the new value.
This method can also set additional value and type information for the specified
key. The key identified by the key parameter must have been opened with
<a class="reference internal" href="#winreg.KEY_SET_VALUE" title="winreg.KEY_SET_VALUE"><code class="xref py py-const docutils literal notranslate">KEY_SET_VALUE</code></a> access.
To open the key, use the <a class="reference internal" href="#winreg.CreateKey" title="winreg.CreateKey"><code class="xref py py-func docutils literal notranslate">CreateKey()</code></a> or <a class="reference internal" href="#winreg.OpenKey" title="winreg.OpenKey"><code class="xref py py-func docutils literal notranslate">OpenKey()</code></a> methods.
Value lengths are limited by available memory. Long values (more than 2048
bytes) should be stored as files with the filenames stored in the configuration
registry. This helps the registry perform efficiently.
Raises an <a class="reference internal" href="sys.html#auditing">auditing event</a> <code class="docutils literal notranslate">winreg.SetValue</code> with arguments <code class="docutils literal notranslate">key</code>, <code class="docutils literal notranslate">sub_key</code>, <code class="docutils literal notranslate">type</code>, <code class="docutils literal notranslate">value</code>.
</dd></dl>

<dl class="py function">
<dt class="sig sig-object py" id="winreg.DisableReflectionKey">
winreg.DisableReflectionKey(key)<a class="headerlink" href="#winreg.DisableReflectionKey" title="Permalink to this definition">¶</a></dt>
<dd>Disables registry reflection for 32-bit processes running on a 64-bit
operating system.
key is an already open key, or one of the predefined <a class="reference internal" href="#hkey-constants">HKEY_* constants</a>.
Will generally raise <a class="reference internal" href="exceptions.html#NotImplementedError" title="NotImplementedError"><code class="xref py py-exc docutils literal notranslate">NotImplementedError</code></a> if executed on a 32-bit operating
system.
If the key is not on the reflection list, the function succeeds but has no
effect. Disabling reflection for a key does not affect reflection of any
subkeys.
Raises an <a class="reference internal" href="sys.html#auditing">auditing event</a> <code class="docutils literal notranslate">winreg.DisableReflectionKey</code> with argument <code class="docutils literal notranslate">key</code>.
</dd></dl>

<dl class="py function">
<dt class="sig sig-object py" id="winreg.EnableReflectionKey">
winreg.EnableReflectionKey(key)<a class="headerlink" href="#winreg.EnableReflectionKey" title="Permalink to this definition">¶</a></dt>
<dd>Restores registry reflection for the specified disabled key.
key is an already open key, or one of the predefined <a class="reference internal" href="#hkey-constants">HKEY_* constants</a>.
Will generally raise <a class="reference internal" href="exceptions.html#NotImplementedError" title="NotImplementedError"><code class="xref py py-exc docutils literal notranslate">NotImplementedError</code></a> if executed on a 32-bit operating
system.
Restoring reflection for a key does not affect reflection of any subkeys.
Raises an <a class="reference internal" href="sys.html#auditing">auditing event</a> <code class="docutils literal notranslate">winreg.EnableReflectionKey</code> with argument <code class="docutils literal notranslate">key</code>.
</dd></dl>

<dl class="py function">
<dt class="sig sig-object py" id="winreg.QueryReflectionKey">
winreg.QueryReflectionKey(key)<a class="headerlink" href="#winreg.QueryReflectionKey" title="Permalink to this definition">¶</a></dt>
<dd>Determines the reflection state for the specified key.
key is an already open key, or one of the predefined
<a class="reference internal" href="#hkey-constants">HKEY_* constants</a>.
Returns <code class="docutils literal notranslate">True</code> if reflection is disabled.
Will generally raise <a class="reference internal" href="exceptions.html#NotImplementedError" title="NotImplementedError"><code class="xref py py-exc docutils literal notranslate">NotImplementedError</code></a> if executed on a 32-bit
operating system.
Raises an <a class="reference internal" href="sys.html#auditing">auditing event</a> <code class="docutils literal notranslate">winreg.QueryReflectionKey</code> with argument <code class="docutils literal notranslate">key</code>.
</dd></dl>

</section>
<section id="constants">
<h2>Constants<a class="headerlink" href="#constants" title="Permalink to this headline">¶</a></h2>
The following constants are defined for use in many <code class="xref py py-mod docutils literal notranslate">_winreg</code> functions.
<section id="hkey-constants">
<h3>HKEY_* Constants<a class="headerlink" href="#hkey-constants" title="Permalink to this headline">¶</a></h3>
<dl class="py data">
<dt class="sig sig-object py" id="winreg.HKEY_CLASSES_ROOT">
winreg.HKEY_CLASSES_ROOT<a class="headerlink" href="#winreg.HKEY_CLASSES_ROOT" title="Permalink to this definition">¶</a></dt>
<dd>Registry entries subordinate to this key define types (or classes) of
documents and the properties associated with those types. Shell and
COM applications use the information stored under this key.
</dd></dl>

<dl class="py data">
<dt class="sig sig-object py" id="winreg.HKEY_CURRENT_USER">
winreg.HKEY_CURRENT_USER<a class="headerlink" href="#winreg.HKEY_CURRENT_USER" title="Permalink to this definition">¶</a></dt>
<dd>Registry entries subordinate to this key define the preferences of
the current user. These preferences include the settings of
environment variables, data about program groups, colors, printers,
network connections, and application preferences.
</dd></dl>

<dl class="py data">
<dt class="sig sig-object py" id="winreg.HKEY_LOCAL_MACHINE">
winreg.HKEY_LOCAL_MACHINE<a class="headerlink" href="#winreg.HKEY_LOCAL_MACHINE" title="Permalink to this definition">¶</a></dt>
<dd>Registry entries subordinate to this key define the physical state
of the computer, including data about the bus type, system memory,
and installed hardware and software.
</dd></dl>

<dl class="py data">
<dt class="sig sig-object py" id="winreg.HKEY_USERS">
winreg.HKEY_USERS<a class="headerlink" href="#winreg.HKEY_USERS" title="Permalink to this definition">¶</a></dt>
<dd>Registry entries subordinate to this key define the default user
configuration for new users on the local computer and the user
configuration for the current user.
</dd></dl>

<dl class="py data">
<dt class="sig sig-object py" id="winreg.HKEY_PERFORMANCE_DATA">
winreg.HKEY_PERFORMANCE_DATA<a class="headerlink" href="#winreg.HKEY_PERFORMANCE_DATA" title="Permalink to this definition">¶</a></dt>
<dd>Registry entries subordinate to this key allow you to access
performance data. The data is not actually stored in the registry;
the registry functions cause the system to collect the data from
its source.
</dd></dl>

<dl class="py data">
<dt class="sig sig-object py" id="winreg.HKEY_CURRENT_CONFIG">
winreg.HKEY_CURRENT_CONFIG<a class="headerlink" href="#winreg.HKEY_CURRENT_CONFIG" title="Permalink to this definition">¶</a></dt>
<dd>Contains information about the current hardware profile of the
local computer system.
</dd></dl>

<dl class="py data">
<dt class="sig sig-object py" id="winreg.HKEY_DYN_DATA">
winreg.HKEY_DYN_DATA<a class="headerlink" href="#winreg.HKEY_DYN_DATA" title="Permalink to this definition">¶</a></dt>
<dd>This key is not used in versions of Windows after 98.
</dd></dl>

</section>
<section id="access-rights">
<h3>Access Rights<a class="headerlink" href="#access-rights" title="Permalink to this headline">¶</a></h3>
For more information, see <a class="reference external" href="https://msdn.microsoft.com/en-us/library/ms724878%28v=VS.85%29.aspx">Registry Key Security and Access</a>.
<dl class="py data">
<dt class="sig sig-object py" id="winreg.KEY_ALL_ACCESS">
winreg.KEY_ALL_ACCESS<a class="headerlink" href="#winreg.KEY_ALL_ACCESS" title="Permalink to this definition">¶</a></dt>
<dd>Combines the STANDARD_RIGHTS_REQUIRED, <a class="reference internal" href="#winreg.KEY_QUERY_VALUE" title="winreg.KEY_QUERY_VALUE"><code class="xref py py-const docutils literal notranslate">KEY_QUERY_VALUE</code></a>,
<a class="reference internal" href="#winreg.KEY_SET_VALUE" title="winreg.KEY_SET_VALUE"><code class="xref py py-const docutils literal notranslate">KEY_SET_VALUE</code></a>, <a class="reference internal" href="#winreg.KEY_CREATE_SUB_KEY" title="winreg.KEY_CREATE_SUB_KEY"><code class="xref py py-const docutils literal notranslate">KEY_CREATE_SUB_KEY</code></a>,
<a class="reference internal" href="#winreg.KEY_ENUMERATE_SUB_KEYS" title="winreg.KEY_ENUMERATE_SUB_KEYS"><code class="xref py py-const docutils literal notranslate">KEY_ENUMERATE_SUB_KEYS</code></a>, <a class="reference internal" href="#winreg.KEY_NOTIFY" title="winreg.KEY_NOTIFY"><code class="xref py py-const docutils literal notranslate">KEY_NOTIFY</code></a>,
and <a class="reference internal" href="#winreg.KEY_CREATE_LINK" title="winreg.KEY_CREATE_LINK"><code class="xref py py-const docutils literal notranslate">KEY_CREATE_LINK</code></a> access rights.
</dd></dl>

<dl class="py data">
<dt class="sig sig-object py" id="winreg.KEY_WRITE">
winreg.KEY_WRITE<a class="headerlink" href="#winreg.KEY_WRITE" title="Permalink to this definition">¶</a></dt>
<dd>Combines the STANDARD_RIGHTS_WRITE, <a class="reference internal" href="#winreg.KEY_SET_VALUE" title="winreg.KEY_SET_VALUE"><code class="xref py py-const docutils literal notranslate">KEY_SET_VALUE</code></a>, and
<a class="reference internal" href="#winreg.KEY_CREATE_SUB_KEY" title="winreg.KEY_CREATE_SUB_KEY"><code class="xref py py-const docutils literal notranslate">KEY_CREATE_SUB_KEY</code></a> access rights.
</dd></dl>

<dl class="py data">
<dt class="sig sig-object py" id="winreg.KEY_READ">
winreg.KEY_READ<a class="headerlink" href="#winreg.KEY_READ" title="Permalink to this definition">¶</a></dt>
<dd>Combines the STANDARD_RIGHTS_READ, <a class="reference internal" href="#winreg.KEY_QUERY_VALUE" title="winreg.KEY_QUERY_VALUE"><code class="xref py py-const docutils literal notranslate">KEY_QUERY_VALUE</code></a>,
<a class="reference internal" href="#winreg.KEY_ENUMERATE_SUB_KEYS" title="winreg.KEY_ENUMERATE_SUB_KEYS"><code class="xref py py-const docutils literal notranslate">KEY_ENUMERATE_SUB_KEYS</code></a>, and <a class="reference internal" href="#winreg.KEY_NOTIFY" title="winreg.KEY_NOTIFY"><code class="xref py py-const docutils literal notranslate">KEY_NOTIFY</code></a> values.
</dd></dl>

<dl class="py data">
<dt class="sig sig-object py" id="winreg.KEY_EXECUTE">
winreg.KEY_EXECUTE<a class="headerlink" href="#winreg.KEY_EXECUTE" title="Permalink to this definition">¶</a></dt>
<dd>Equivalent to <a class="reference internal" href="#winreg.KEY_READ" title="winreg.KEY_READ"><code class="xref py py-const docutils literal notranslate">KEY_READ</code></a>.
</dd></dl>

<dl class="py data">
<dt class="sig sig-object py" id="winreg.KEY_QUERY_VALUE">
winreg.KEY_QUERY_VALUE<a class="headerlink" href="#winreg.KEY_QUERY_VALUE" title="Permalink to this definition">¶</a></dt>
<dd>Required to query the values of a registry key.
</dd></dl>

<dl class="py data">
<dt class="sig sig-object py" id="winreg.KEY_SET_VALUE">
winreg.KEY_SET_VALUE<a class="headerlink" href="#winreg.KEY_SET_VALUE" title="Permalink to this definition">¶</a></dt>
<dd>Required to create, delete, or set a registry value.
</dd></dl>

<dl class="py data">
<dt class="sig sig-object py" id="winreg.KEY_CREATE_SUB_KEY">
winreg.KEY_CREATE_SUB_KEY<a class="headerlink" href="#winreg.KEY_CREATE_SUB_KEY" title="Permalink to this definition">¶</a></dt>
<dd>Required to create a subkey of a registry key.
</dd></dl>

<dl class="py data">
<dt class="sig sig-object py" id="winreg.KEY_ENUMERATE_SUB_KEYS">
winreg.KEY_ENUMERATE_SUB_KEYS<a class="headerlink" href="#winreg.KEY_ENUMERATE_SUB_KEYS" title="Permalink to this definition">¶</a></dt>
<dd>Required to enumerate the subkeys of a registry key.
</dd></dl>

<dl class="py data">
<dt class="sig sig-object py" id="winreg.KEY_NOTIFY">
winreg.KEY_NOTIFY<a class="headerlink" href="#winreg.KEY_NOTIFY" title="Permalink to this definition">¶</a></dt>
<dd>Required to request change notifications for a registry key or for
subkeys of a registry key.
</dd></dl>

<dl class="py data">
<dt class="sig sig-object py" id="winreg.KEY_CREATE_LINK">
winreg.KEY_CREATE_LINK<a class="headerlink" href="#winreg.KEY_CREATE_LINK" title="Permalink to this definition">¶</a></dt>
<dd>Reserved for system use.
</dd></dl>

<section id="bit-specific">
<h4>64-bit Specific<a class="headerlink" href="#bit-specific" title="Permalink to this headline">¶</a></h4>
For more information, see <a class="reference external" href="https://msdn.microsoft.com/en-us/library/aa384129(v=VS.85).aspx">Accessing an Alternate Registry View</a>.
<dl class="py data">
<dt class="sig sig-object py" id="winreg.KEY_WOW64_64KEY">
winreg.KEY_WOW64_64KEY<a class="headerlink" href="#winreg.KEY_WOW64_64KEY" title="Permalink to this definition">¶</a></dt>
<dd>Indicates that an application on 64-bit Windows should operate on
the 64-bit registry view. On 32-bit Windows, this constant is ignored.
</dd></dl>

<dl class="py data">
<dt class="sig sig-object py" id="winreg.KEY_WOW64_32KEY">
winreg.KEY_WOW64_32KEY<a class="headerlink" href="#winreg.KEY_WOW64_32KEY" title="Permalink to this definition">¶</a></dt>
<dd>Indicates that an application on 64-bit Windows should operate on
the 32-bit registry view. On 32-bit Windows, this constant is ignored.
</dd></dl>

</section>
</section>
<section id="value-types">
<h3>Value Types<a class="headerlink" href="#value-types" title="Permalink to this headline">¶</a></h3>
For more information, see <a class="reference external" href="https://msdn.microsoft.com/en-us/library/ms724884%28v=VS.85%29.aspx">Registry Value Types</a>.
<dl class="py data">
<dt class="sig sig-object py" id="winreg.REG_BINARY">
winreg.REG_BINARY<a class="headerlink" href="#winreg.REG_BINARY" title="Permalink to this definition">¶</a></dt>
<dd>Binary data in any form.
</dd></dl>

<dl class="py data">
<dt class="sig sig-object py" id="winreg.REG_DWORD">
winreg.REG_DWORD<a class="headerlink" href="#winreg.REG_DWORD" title="Permalink to this definition">¶</a></dt>
<dd>32-bit number.
</dd></dl>

<dl class="py data">
<dt class="sig sig-object py" id="winreg.REG_DWORD_LITTLE_ENDIAN">
winreg.REG_DWORD_LITTLE_ENDIAN<a class="headerlink" href="#winreg.REG_DWORD_LITTLE_ENDIAN" title="Permalink to this definition">¶</a></dt>
<dd>A 32-bit number in little-endian format. Equivalent to <a class="reference internal" href="#winreg.REG_DWORD" title="winreg.REG_DWORD"><code class="xref py py-const docutils literal notranslate">REG_DWORD</code></a>.
</dd></dl>

<dl class="py data">
<dt class="sig sig-object py" id="winreg.REG_DWORD_BIG_ENDIAN">
winreg.REG_DWORD_BIG_ENDIAN<a class="headerlink" href="#winreg.REG_DWORD_BIG_ENDIAN" title="Permalink to this definition">¶</a></dt>
<dd>A 32-bit number in big-endian format.
</dd></dl>

<dl class="py data">
<dt class="sig sig-object py" id="winreg.REG_EXPAND_SZ">
winreg.REG_EXPAND_SZ<a class="headerlink" href="#winreg.REG_EXPAND_SZ" title="Permalink to this definition">¶</a></dt>
<dd>Null-terminated string containing references to environment
variables (<code class="docutils literal notranslate">%PATH%</code>).
</dd></dl>

<dl class="py data">
<dt class="sig sig-object py" id="winreg.REG_LINK">
winreg.REG_LINK<a class="headerlink" href="#winreg.REG_LINK" title="Permalink to this definition">¶</a></dt>
<dd>A Unicode symbolic link.
</dd></dl>

<dl class="py data">
<dt class="sig sig-object py" id="winreg.REG_MULTI_SZ">
winreg.REG_MULTI_SZ<a class="headerlink" href="#winreg.REG_MULTI_SZ" title="Permalink to this definition">¶</a></dt>
<dd>A sequence of null-terminated strings, terminated by two null characters.
(Python handles this termination automatically.)
</dd></dl>

<dl class="py data">
<dt class="sig sig-object py" id="winreg.REG_NONE">
winreg.REG_NONE<a class="headerlink" href="#winreg.REG_NONE" title="Permalink to this definition">¶</a></dt>
<dd>No defined value type.
</dd></dl>

<dl class="py data">
<dt class="sig sig-object py" id="winreg.REG_QWORD">
winreg.REG_QWORD<a class="headerlink" href="#winreg.REG_QWORD" title="Permalink to this definition">¶</a></dt>
<dd>A 64-bit number.
<div class="versionadded">
New in version 3.6.
</div>
</dd></dl>

<dl class="py data">
<dt class="sig sig-object py" id="winreg.REG_QWORD_LITTLE_ENDIAN">
winreg.REG_QWORD_LITTLE_ENDIAN<a class="headerlink" href="#winreg.REG_QWORD_LITTLE_ENDIAN" title="Permalink to this definition">¶</a></dt>
<dd>A 64-bit number in little-endian format. Equivalent to <a class="reference internal" href="#winreg.REG_QWORD" title="winreg.REG_QWORD"><code class="xref py py-const docutils literal notranslate">REG_QWORD</code></a>.
<div class="versionadded">
New in version 3.6.
</div>
</dd></dl>

<dl class="py data">
<dt class="sig sig-object py" id="winreg.REG_RESOURCE_LIST">
winreg.REG_RESOURCE_LIST<a class="headerlink" href="#winreg.REG_RESOURCE_LIST" title="Permalink to this definition">¶</a></dt>
<dd>A device-driver resource list.
</dd></dl>

<dl class="py data">
<dt class="sig sig-object py" id="winreg.REG_FULL_RESOURCE_DESCRIPTOR">
winreg.REG_FULL_RESOURCE_DESCRIPTOR<a class="headerlink" href="#winreg.REG_FULL_RESOURCE_DESCRIPTOR" title="Permalink to this definition">¶</a></dt>
<dd>A hardware setting.
</dd></dl>

<dl class="py data">
<dt class="sig sig-object py" id="winreg.REG_RESOURCE_REQUIREMENTS_LIST">
winreg.REG_RESOURCE_REQUIREMENTS_LIST<a class="headerlink" href="#winreg.REG_RESOURCE_REQUIREMENTS_LIST" title="Permalink to this definition">¶</a></dt>
<dd>A hardware resource list.
</dd></dl>

<dl class="py data">
<dt class="sig sig-object py" id="winreg.REG_SZ">
winreg.REG_SZ<a class="headerlink" href="#winreg.REG_SZ" title="Permalink to this definition">¶</a></dt>
<dd>A null-terminated string.
</dd></dl>

</section>
</section>
<section id="registry-handle-objects">
<h2>Registry Handle Objects<a class="headerlink" href="#registry-handle-objects" title="Permalink to this headline">¶</a></h2>
This object wraps a Windows HKEY object, automatically closing it when the
object is destroyed. To guarantee cleanup, you can call either the
<a class="reference internal" href="#winreg.PyHKEY.Close" title="winreg.PyHKEY.Close"><code class="xref py py-meth docutils literal notranslate">Close()</code></a> method on the object, or the <a class="reference internal" href="#winreg.CloseKey" title="winreg.CloseKey"><code class="xref py py-func docutils literal notranslate">CloseKey()</code></a> function.
All registry functions in this module return one of these objects.
All registry functions in this module which accept a handle object also accept
an integer, however, use of the handle object is encouraged.
Handle objects provide semantics for <code class="xref py py-meth docutils literal notranslate">__bool__()</code> – thus
<div class="highlight-python3 notranslate"><div class="highlight"><pre>if handle:
 print(&quot;Yes&quot;)
</pre></div>
</div>
will print <code class="docutils literal notranslate">Yes</code> if the handle is currently valid (has not been closed or
detached).
The object also support comparison semantics, so handle objects will compare
true if they both reference the same underlying Windows handle value.
Handle objects can be converted to an integer (e.g., using the built-in
<a class="reference internal" href="functions.html#int" title="int"><code class="xref py py-func docutils literal notranslate">int()</code></a> function), in which case the underlying Windows handle value is
returned. You can also use the <a class="reference internal" href="#winreg.PyHKEY.Detach" title="winreg.PyHKEY.Detach"><code class="xref py py-meth docutils literal notranslate">Detach()</code></a> method to return the
integer handle, and also disconnect the Windows handle from the handle object.
<dl class="py method">
<dt class="sig sig-object py" id="winreg.PyHKEY.Close">
PyHKEY.Close()<a class="headerlink" href="#winreg.PyHKEY.Close" title="Permalink to this definition">¶</a></dt>
<dd>Closes the underlying Windows handle.
If the handle is already closed, no error is raised.
</dd></dl>

<dl class="py method">
<dt class="sig sig-object py" id="winreg.PyHKEY.Detach">
PyHKEY.Detach()<a class="headerlink" href="#winreg.PyHKEY.Detach" title="Permalink to this definition">¶</a></dt>
<dd>Detaches the Windows handle from the handle object.
The result is an integer that holds the value of the handle before it is
detached. If the handle is already detached or closed, this will return
zero.
After calling this function, the handle is effectively invalidated, but the
handle is not closed. You would call this function when you need the
underlying Win32 handle to exist beyond the lifetime of the handle object.
Raises an <a class="reference internal" href="sys.html#auditing">auditing event</a> <code class="docutils literal notranslate">winreg.PyHKEY.Detach</code> with argument <code class="docutils literal notranslate">key</code>.
</dd></dl>

<dl class="py method">
<dt class="sig sig-object py" id="winreg.PyHKEY.__enter__">
PyHKEY.__enter__()<a class="headerlink" href="#winreg.PyHKEY.__enter__" title="Permalink to this definition">¶</a></dt>
<dt class="sig sig-object py" id="winreg.PyHKEY.__exit__">
PyHKEY.__exit__(*exc_info)<a class="headerlink" href="#winreg.PyHKEY.__exit__" title="Permalink to this definition">¶</a></dt>
<dd>The HKEY object implements <a class="reference internal" href="../reference/datamodel.html#object.__enter__" title="object.__enter__"><code class="xref py py-meth docutils literal notranslate">__enter__()</code></a> and
<a class="reference internal" href="../reference/datamodel.html#object.__exit__" title="object.__exit__"><code class="xref py py-meth docutils literal notranslate">__exit__()</code></a> and thus supports the context protocol for the
<a class="reference internal" href="../reference/compound_stmts.html#with"><code class="xref std std-keyword docutils literal notranslate">with</code></a> statement:
<div class="highlight-python3 notranslate"><div class="highlight"><pre>with OpenKey(HKEY_LOCAL_MACHINE, &quot;foo&quot;) as key:
 ... # work with key
</pre></div>
</div>
will automatically close key when control leaves the <a class="reference internal" href="../reference/compound_stmts.html#with"><code class="xref std std-keyword docutils literal notranslate">with</code></a> block.
</dd></dl>

</section>
</section>

<div class="clearer"></div>
 </div>
 </div>
 </div>
 <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
 <div class="sphinxsidebarwrapper">
 <h3><a href="../contents.html">Table of Contents</a></h3>
 <ul>
<li><a class="reference internal" href="#"><code class="xref py py-mod docutils literal notranslate">winreg</code> — Windows registry access</a><ul>
<li><a class="reference internal" href="#functions">Functions</a></li>
<li><a class="reference internal" href="#constants">Constants</a><ul>
<li><a class="reference internal" href="#hkey-constants">HKEY_* Constants</a></li>
<li><a class="reference internal" href="#access-rights">Access Rights</a><ul>
<li><a class="reference internal" href="#bit-specific">64-bit Specific</a></li>
</ul>
</li>
<li><a class="reference internal" href="#value-types">Value Types</a></li>
</ul>
</li>
<li><a class="reference internal" href="#registry-handle-objects">Registry Handle Objects</a></li>
</ul>
</li>
</ul>

<h4>Previous topic</h4>
 <a href="msvcrt.html"
 title="previous chapter"><code class="xref py py-mod docutils literal notranslate">msvcrt</code> — Useful routines from the MS VC++ runtime</a>
 <h4>Next topic</h4>
 <a href="winsound.html"
 title="next chapter"><code class="xref py py-mod docutils literal notranslate">winsound</code> — Sound-playing interface for Windows</a>
 <div role="note" aria-label="source link">
 <h3>This Page</h3>
 <ul class="this-page-menu">
 <li><a href="../bugs.html">Report a Bug</a></li>
 <li>
 <a href="https://github.com/python/cpython/blob/3.10/Doc/library/winreg.rst"
 rel="nofollow">Show Source
 </a>
 </li>
 </ul>
 </div>
 </div>
 </div>
 <div class="clearer"></div>
 </div> 
 <div class="related" role="navigation" aria-label="related navigation">
 <h3>Navigation</h3>
 <ul>
 <li class="right" style="margin-right: 10px">
 <a href="../genindex.html" title="General Index"
 >index</a></li>
 <li class="right" >
 <a href="../py-modindex.html" title="Python Module Index"
 >modules</a> |</li>
 <li class="right" >
 <a href="winsound.html" title="winsound — Sound-playing interface for Windows"
 >next</a> |</li>
 <li class="right" >
 <a href="msvcrt.html" title="msvcrt — Useful routines from the MS VC++ runtime"
 >previous</a> |</li>

<li class="nav-item nav-item-1"><a href="index.html" >The Python Standard Library</a> &#187;</li>
 <li class="nav-item nav-item-2"><a href="windows.html" >MS Windows Specific Services</a> &#187;</li>
 <li class="nav-item nav-item-this"><a href=""><code class="xref py py-mod docutils literal notranslate">winreg</code> — Windows registry access</a></li>
 <li class="right">

<div class="inline-search" role="search">
 <form class="inline-search" action="../search.html" method="get">
 <input placeholder="Quick search" aria-label="Quick search" type="text" name="q" />
 <input type="submit" value="Go" />
 <input type="hidden" name="check_keywords" value="yes" />
 <input type="hidden" name="area" value="default" />
 </form>
 </div>
 |
 </li>
 
 </ul>
 </div> 
 <div class="footer">
 &copy; <a href="../copyright.html">Copyright</a> 2001-2026, Python Software Foundation.
 
 This page is licensed under the Python Software Foundation License Version 2.
 
 Examples, recipes, and other code in the documentation are additionally licensed under the Zero Clause BSD License.
 
 See <a href="/license.html">History and License</a> for more information.

The Python Software Foundation is a non-profit corporation.
<a href="https://www.python.org/psf/donations/">Please donate.</a>

Last updated on January 26, 2026.
 <a href="/bugs.html">Found a bug</a>?

Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 4.3.2.
 </div>

</body>
</html>

${this.title}

Code Editor : winreg.html