python-docs-fr/library/_winreg.po

838 lines
25 KiB
Plaintext

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 1990-2016, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 2.7\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2016-10-30 10:44+0100\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../Doc/library/_winreg.rst:2
msgid ":mod:`_winreg` -- Windows registry access"
msgstr ""
#: ../Doc/library/_winreg.rst:10
msgid ""
"The :mod:`_winreg` module has been renamed to :mod:`winreg` in Python 3. "
"The :term:`2to3` tool will automatically adapt imports when converting your "
"sources to Python 3."
msgstr ""
#: ../Doc/library/_winreg.rst:17
msgid ""
"These functions expose the Windows registry API to Python. Instead of using "
"an integer as the registry handle, a :ref:`handle object <handle-object>` is "
"used to ensure that the handles are closed correctly, even if the programmer "
"neglects to explicitly close them."
msgstr ""
#: ../Doc/library/_winreg.rst:22
msgid "This module offers the following functions:"
msgstr ""
#: ../Doc/library/_winreg.rst:27
msgid ""
"Closes a previously opened registry key. The *hkey* argument specifies a "
"previously opened key."
msgstr ""
#: ../Doc/library/_winreg.rst:31
msgid ""
"If *hkey* is not closed using this method (or via :meth:`hkey.Close() "
"<PyHKEY.Close>`), it is closed when the *hkey* object is destroyed by Python."
msgstr ""
#: ../Doc/library/_winreg.rst:37
msgid ""
"Establishes a connection to a predefined registry handle on another "
"computer, and returns a :ref:`handle object <handle-object>`."
msgstr ""
#: ../Doc/library/_winreg.rst:40
msgid ""
"*computer_name* is the name of the remote computer, of the form ``r\"\\"
"\\computername\"``. If ``None``, the local computer is used."
msgstr ""
#: ../Doc/library/_winreg.rst:43
msgid "*key* is the predefined handle to connect to."
msgstr ""
#: ../Doc/library/_winreg.rst:45 ../Doc/library/_winreg.rst:64
#: ../Doc/library/_winreg.rst:90
msgid ""
"The return value is the handle of the opened key. If the function fails, a :"
"exc:`WindowsError` exception is raised."
msgstr ""
#: ../Doc/library/_winreg.rst:51 ../Doc/library/_winreg.rst:70
msgid ""
"Creates or opens the specified key, returning a :ref:`handle object <handle-"
"object>`."
msgstr ""
#: ../Doc/library/_winreg.rst:54 ../Doc/library/_winreg.rst:73
#: ../Doc/library/_winreg.rst:150 ../Doc/library/_winreg.rst:215
#: ../Doc/library/_winreg.rst:285 ../Doc/library/_winreg.rst:309
#: ../Doc/library/_winreg.rst:327 ../Doc/library/_winreg.rst:349
#: ../Doc/library/_winreg.rst:372 ../Doc/library/_winreg.rst:398
#: ../Doc/library/_winreg.rst:427 ../Doc/library/_winreg.rst:442
#: ../Doc/library/_winreg.rst:455
msgid ""
"*key* is an already open key, or one of the predefined :ref:`HKEY_* "
"constants <hkey-constants>`."
msgstr ""
#: ../Doc/library/_winreg.rst:57 ../Doc/library/_winreg.rst:76
msgid "*sub_key* is a string that names the key this method opens or creates."
msgstr ""
#: ../Doc/library/_winreg.rst:59 ../Doc/library/_winreg.rst:85
msgid ""
"If *key* is one of the predefined keys, *sub_key* may be ``None``. In that "
"case, the handle returned is the same key handle passed in to the function."
msgstr ""
#: ../Doc/library/_winreg.rst:62 ../Doc/library/_winreg.rst:88
msgid "If the key already exists, this function opens the existing key."
msgstr ""
#: ../Doc/library/_winreg.rst:78 ../Doc/library/_winreg.rst:129
msgid "*res* is a reserved integer, and must be zero. The default is zero."
msgstr ""
#: ../Doc/library/_winreg.rst:80
msgid ""
"*sam* is an integer that specifies an access mask that describes the desired "
"security access for the key. Default is :const:`KEY_ALL_ACCESS`. See :ref:"
"`Access Rights <access-rights>` for other allowed values."
msgstr ""
#: ../Doc/library/_winreg.rst:98 ../Doc/library/_winreg.rst:114
msgid "Deletes the specified key."
msgstr ""
#: ../Doc/library/_winreg.rst:100 ../Doc/library/_winreg.rst:122
#: ../Doc/library/_winreg.rst:160 ../Doc/library/_winreg.rst:174
#: ../Doc/library/_winreg.rst:259
msgid ""
"*key* is an already open key, or any one of the predefined :ref:`HKEY_* "
"constants <hkey-constants>`."
msgstr ""
#: ../Doc/library/_winreg.rst:103
msgid ""
"*sub_key* is a string that must be a subkey of the key identified by the "
"*key* parameter. This value must not be ``None``, and the key may not have "
"subkeys."
msgstr ""
#: ../Doc/library/_winreg.rst:106 ../Doc/library/_winreg.rst:136
msgid "*This method can not delete keys with subkeys.*"
msgstr ""
#: ../Doc/library/_winreg.rst:108 ../Doc/library/_winreg.rst:138
msgid ""
"If the method succeeds, the entire key, including all of its values, is "
"removed. If the method fails, a :exc:`WindowsError` exception is raised."
msgstr ""
#: ../Doc/library/_winreg.rst:117
msgid ""
"The :func:`DeleteKeyEx` function is implemented with the RegDeleteKeyEx "
"Windows API function, which is specific to 64-bit versions of Windows. See "
"the `RegDeleteKeyEx documentation <http://msdn.microsoft.com/en-us/library/"
"ms724847%28VS.85%29.aspx>`__."
msgstr ""
#: ../Doc/library/_winreg.rst:125
msgid ""
"*sub_key* is a string that must be a subkey of the key identified by the "
"*key* parameter. This value must not be ``None``, and the key may not have "
"subkeys."
msgstr ""
#: ../Doc/library/_winreg.rst:131
msgid ""
"*sam* is an integer that specifies an access mask that describes the desired "
"security access for the key. Default is :const:`KEY_WOW64_64KEY`. See :ref:"
"`Access Rights <access-rights>` for other allowed values."
msgstr ""
#: ../Doc/library/_winreg.rst:141
msgid "On unsupported Windows versions, :exc:`NotImplementedError` is raised."
msgstr ""
#: ../Doc/library/_winreg.rst:148
msgid "Removes a named value from a registry key."
msgstr ""
#: ../Doc/library/_winreg.rst:153
msgid "*value* is a string that identifies the value to remove."
msgstr ""
#: ../Doc/library/_winreg.rst:158
msgid "Enumerates subkeys of an open registry key, returning a string."
msgstr ""
#: ../Doc/library/_winreg.rst:163
msgid "*index* is an integer that identifies the index of the key to retrieve."
msgstr ""
#: ../Doc/library/_winreg.rst:165
msgid ""
"The function retrieves the name of one subkey each time it is called. It is "
"typically called repeatedly until a :exc:`WindowsError` exception is raised, "
"indicating, no more values are available."
msgstr ""
#: ../Doc/library/_winreg.rst:172
msgid "Enumerates values of an open registry key, returning a tuple."
msgstr ""
#: ../Doc/library/_winreg.rst:177
msgid ""
"*index* is an integer that identifies the index of the value to retrieve."
msgstr ""
#: ../Doc/library/_winreg.rst:179
msgid ""
"The function retrieves the name of one subkey each time it is called. It is "
"typically called repeatedly, until a :exc:`WindowsError` exception is "
"raised, indicating no more values."
msgstr ""
#: ../Doc/library/_winreg.rst:183 ../Doc/library/_winreg.rst:288
msgid "The result is a tuple of 3 items:"
msgstr ""
#: ../Doc/library/_winreg.rst:186 ../Doc/library/_winreg.rst:291
#: ../Doc/library/_winreg.rst:335
msgid "Index"
msgstr "Index"
#: ../Doc/library/_winreg.rst:186 ../Doc/library/_winreg.rst:291
#: ../Doc/library/_winreg.rst:335
msgid "Meaning"
msgstr "Signification"
#: ../Doc/library/_winreg.rst:188 ../Doc/library/_winreg.rst:293
#: ../Doc/library/_winreg.rst:337
msgid "``0``"
msgstr "``0``"
#: ../Doc/library/_winreg.rst:188
msgid "A string that identifies the value name"
msgstr ""
#: ../Doc/library/_winreg.rst:190 ../Doc/library/_winreg.rst:296
#: ../Doc/library/_winreg.rst:339
msgid "``1``"
msgstr "``1``"
#: ../Doc/library/_winreg.rst:190
msgid ""
"An object that holds the value data, and whose type depends on the "
"underlying registry type"
msgstr ""
#: ../Doc/library/_winreg.rst:194 ../Doc/library/_winreg.rst:299
msgid "``2``"
msgstr "``2``"
#: ../Doc/library/_winreg.rst:194
msgid ""
"An integer that identifies the type of the value data (see table in docs "
"for :meth:`SetValueEx`)"
msgstr ""
#: ../Doc/library/_winreg.rst:202
msgid ""
"Expands environment variable placeholders ``%NAME%`` in unicode strings "
"like :const:`REG_EXPAND_SZ`::"
msgstr ""
#: ../Doc/library/_winreg.rst:213
msgid "Writes all the attributes of a key to the registry."
msgstr ""
#: ../Doc/library/_winreg.rst:218
msgid ""
"It is not necessary to call :func:`FlushKey` 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 :func:"
"`CloseKey`, the :func:`FlushKey` method returns only when all the data has "
"been written to the registry. An application should only call :func:"
"`FlushKey` if it requires absolute certainty that registry changes are on "
"disk."
msgstr ""
#: ../Doc/library/_winreg.rst:227
msgid ""
"If you don't know whether a :func:`FlushKey` call is required, it probably "
"isn't."
msgstr ""
#: ../Doc/library/_winreg.rst:233
msgid ""
"Creates a subkey under the specified key and stores registration information "
"from a specified file into that subkey."
msgstr ""
#: ../Doc/library/_winreg.rst:236
msgid ""
"*key* is a handle returned by :func:`ConnectRegistry` or one of the "
"constants :const:`HKEY_USERS` or :const:`HKEY_LOCAL_MACHINE`."
msgstr ""
#: ../Doc/library/_winreg.rst:239
msgid "*sub_key* is a string that identifies the subkey to load."
msgstr ""
#: ../Doc/library/_winreg.rst:241
msgid ""
"*file_name* is the name of the file to load registry data from. This file "
"must have been created with the :func:`SaveKey` function. Under the file "
"allocation table (FAT) file system, the filename may not have an extension."
msgstr ""
#: ../Doc/library/_winreg.rst:245
msgid ""
"A call to :func:`LoadKey` fails if the calling process does not have the :"
"const:`SE_RESTORE_PRIVILEGE` privilege. Note that privileges are different "
"from permissions -- see the `RegLoadKey documentation <http://msdn.microsoft."
"com/en-us/library/ms724889%28v=VS.85%29.aspx>`__ for more details."
msgstr ""
#: ../Doc/library/_winreg.rst:251
msgid ""
"If *key* is a handle returned by :func:`ConnectRegistry`, then the path "
"specified in *file_name* is relative to the remote computer."
msgstr ""
#: ../Doc/library/_winreg.rst:257
msgid ""
"Opens the specified key, returning a :ref:`handle object <handle-object>`."
msgstr ""
#: ../Doc/library/_winreg.rst:262
msgid "*sub_key* is a string that identifies the sub_key to open."
msgstr ""
#: ../Doc/library/_winreg.rst:264
msgid "*res* is a reserved integer, and must be zero. The default is zero."
msgstr ""
#: ../Doc/library/_winreg.rst:266
msgid ""
"*sam* is an integer that specifies an access mask that describes the desired "
"security access for the key. Default is :const:`KEY_READ`. See :ref:"
"`Access Rights <access-rights>` for other allowed values."
msgstr ""
#: ../Doc/library/_winreg.rst:270
msgid "The result is a new handle to the specified key."
msgstr ""
#: ../Doc/library/_winreg.rst:272
msgid "If the function fails, :exc:`WindowsError` is raised."
msgstr ""
#: ../Doc/library/_winreg.rst:277
msgid ""
"The functionality of :func:`OpenKeyEx` is provided via :func:`OpenKey`, by "
"the use of default arguments."
msgstr ""
#: ../Doc/library/_winreg.rst:283
msgid "Returns information about a key, as a tuple."
msgstr ""
#: ../Doc/library/_winreg.rst:293
msgid "An integer giving the number of sub keys this key has."
msgstr ""
#: ../Doc/library/_winreg.rst:296
msgid "An integer giving the number of values this key has."
msgstr ""
#: ../Doc/library/_winreg.rst:299
msgid ""
"A long integer giving when the key was last modified (if available) as 100's "
"of nanoseconds since Jan 1, 1601."
msgstr ""
#: ../Doc/library/_winreg.rst:307
msgid "Retrieves the unnamed value for a key, as a string."
msgstr ""
#: ../Doc/library/_winreg.rst:312
msgid ""
"*sub_key* is a string that holds the name of the subkey with which the value "
"is associated. If this parameter is ``None`` or empty, the function "
"retrieves the value set by the :func:`SetValue` method for the key "
"identified by *key*."
msgstr ""
#: ../Doc/library/_winreg.rst:316
msgid ""
"Values in the registry have name, type, and data components. This method "
"retrieves the data for a key's first value that has a NULL name. But the "
"underlying API call doesn't return the type, so always use :func:"
"`QueryValueEx` if possible."
msgstr ""
#: ../Doc/library/_winreg.rst:324
msgid ""
"Retrieves the type and data for a specified value name associated with an "
"open registry key."
msgstr ""
#: ../Doc/library/_winreg.rst:330
msgid "*value_name* is a string indicating the value to query."
msgstr ""
#: ../Doc/library/_winreg.rst:332
msgid "The result is a tuple of 2 items:"
msgstr ""
#: ../Doc/library/_winreg.rst:337
msgid "The value of the registry item."
msgstr ""
#: ../Doc/library/_winreg.rst:339
msgid ""
"An integer giving the registry type for this value (see table in docs for :"
"meth:`SetValueEx`)"
msgstr ""
#: ../Doc/library/_winreg.rst:347
msgid "Saves the specified key, and all its subkeys to the specified file."
msgstr ""
#: ../Doc/library/_winreg.rst:352
msgid ""
"*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 :meth:`LoadKey` "
"method."
msgstr ""
#: ../Doc/library/_winreg.rst:357
msgid ""
"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 :const:`SeBackupPrivilege` security privilege. Note that "
"privileges are different than permissions -- see the `Conflicts Between User "
"Rights and Permissions documentation <http://msdn.microsoft.com/en-us/"
"library/ms724878%28v=VS.85%29.aspx>`__ for more details."
msgstr ""
#: ../Doc/library/_winreg.rst:365
msgid "This function passes NULL for *security_attributes* to the API."
msgstr ""
#: ../Doc/library/_winreg.rst:370
msgid "Associates a value with a specified key."
msgstr ""
#: ../Doc/library/_winreg.rst:375
msgid ""
"*sub_key* is a string that names the subkey with which the value is "
"associated."
msgstr ""
#: ../Doc/library/_winreg.rst:377
msgid ""
"*type* is an integer that specifies the type of the data. Currently this "
"must be :const:`REG_SZ`, meaning only strings are supported. Use the :func:"
"`SetValueEx` function for support for other data types."
msgstr ""
#: ../Doc/library/_winreg.rst:381 ../Doc/library/_winreg.rst:409
msgid "*value* is a string that specifies the new value."
msgstr ""
#: ../Doc/library/_winreg.rst:383
msgid ""
"If the key specified by the *sub_key* parameter does not exist, the SetValue "
"function creates it."
msgstr ""
#: ../Doc/library/_winreg.rst:386 ../Doc/library/_winreg.rst:417
msgid ""
"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."
msgstr ""
#: ../Doc/library/_winreg.rst:390
msgid ""
"The key identified by the *key* parameter must have been opened with :const:"
"`KEY_SET_VALUE` access."
msgstr ""
#: ../Doc/library/_winreg.rst:396
msgid "Stores data in the value field of an open registry key."
msgstr ""
#: ../Doc/library/_winreg.rst:401
msgid ""
"*value_name* is a string that names the subkey with which the value is "
"associated."
msgstr ""
#: ../Doc/library/_winreg.rst:404
msgid ""
"*type* is an integer that specifies the type of the data. See :ref:`Value "
"Types <value-types>` for the available types."
msgstr ""
#: ../Doc/library/_winreg.rst:407
msgid "*reserved* can be anything -- zero is always passed to the API."
msgstr ""
#: ../Doc/library/_winreg.rst:411
msgid ""
"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 :const:`KEY_SET_VALUE` access."
msgstr ""
#: ../Doc/library/_winreg.rst:415
msgid "To open the key, use the :func:`CreateKey` or :func:`OpenKey` methods."
msgstr ""
#: ../Doc/library/_winreg.rst:424
msgid ""
"Disables registry reflection for 32-bit processes running on a 64-bit "
"operating system."
msgstr ""
#: ../Doc/library/_winreg.rst:430 ../Doc/library/_winreg.rst:445
#: ../Doc/library/_winreg.rst:460
msgid ""
"Will generally raise :exc:`NotImplemented` if executed on a 32-bit operating "
"system."
msgstr ""
#: ../Doc/library/_winreg.rst:433
msgid ""
"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."
msgstr ""
#: ../Doc/library/_winreg.rst:440
msgid "Restores registry reflection for the specified disabled key."
msgstr ""
#: ../Doc/library/_winreg.rst:448
msgid ""
"Restoring reflection for a key does not affect reflection of any subkeys."
msgstr ""
#: ../Doc/library/_winreg.rst:453
msgid "Determines the reflection state for the specified key."
msgstr ""
#: ../Doc/library/_winreg.rst:458
msgid "Returns ``True`` if reflection is disabled."
msgstr ""
#: ../Doc/library/_winreg.rst:467
msgid "Constants"
msgstr "Constantes"
#: ../Doc/library/_winreg.rst:469
msgid ""
"The following constants are defined for use in many :mod:`_winreg` functions."
msgstr ""
#: ../Doc/library/_winreg.rst:474
msgid "HKEY_* Constants"
msgstr ""
#: ../Doc/library/_winreg.rst:478
msgid ""
"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."
msgstr ""
#: ../Doc/library/_winreg.rst:485
msgid ""
"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."
msgstr ""
#: ../Doc/library/_winreg.rst:492
msgid ""
"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."
msgstr ""
#: ../Doc/library/_winreg.rst:498
msgid ""
"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."
msgstr ""
#: ../Doc/library/_winreg.rst:504
msgid ""
"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."
msgstr ""
#: ../Doc/library/_winreg.rst:512
msgid ""
"Contains information about the current hardware profile of the local "
"computer system."
msgstr ""
#: ../Doc/library/_winreg.rst:517
msgid "This key is not used in versions of Windows after 98."
msgstr ""
#: ../Doc/library/_winreg.rst:523
msgid "Access Rights"
msgstr ""
#: ../Doc/library/_winreg.rst:525
msgid ""
"For more information, see `Registry Key Security and Access <http://msdn."
"microsoft.com/en-us/library/ms724878%28v=VS.85%29.aspx>`__."
msgstr ""
#: ../Doc/library/_winreg.rst:530
msgid ""
"Combines the STANDARD_RIGHTS_REQUIRED, :const:`KEY_QUERY_VALUE`, :const:"
"`KEY_SET_VALUE`, :const:`KEY_CREATE_SUB_KEY`, :const:"
"`KEY_ENUMERATE_SUB_KEYS`, :const:`KEY_NOTIFY`, and :const:`KEY_CREATE_LINK` "
"access rights."
msgstr ""
#: ../Doc/library/_winreg.rst:537
msgid ""
"Combines the STANDARD_RIGHTS_WRITE, :const:`KEY_SET_VALUE`, and :const:"
"`KEY_CREATE_SUB_KEY` access rights."
msgstr ""
#: ../Doc/library/_winreg.rst:542
msgid ""
"Combines the STANDARD_RIGHTS_READ, :const:`KEY_QUERY_VALUE`, :const:"
"`KEY_ENUMERATE_SUB_KEYS`, and :const:`KEY_NOTIFY` values."
msgstr ""
#: ../Doc/library/_winreg.rst:547
msgid "Equivalent to :const:`KEY_READ`."
msgstr ""
#: ../Doc/library/_winreg.rst:551
msgid "Required to query the values of a registry key."
msgstr ""
#: ../Doc/library/_winreg.rst:555
msgid "Required to create, delete, or set a registry value."
msgstr ""
#: ../Doc/library/_winreg.rst:559
msgid "Required to create a subkey of a registry key."
msgstr ""
#: ../Doc/library/_winreg.rst:563
msgid "Required to enumerate the subkeys of a registry key."
msgstr ""
#: ../Doc/library/_winreg.rst:567
msgid ""
"Required to request change notifications for a registry key or for subkeys "
"of a registry key."
msgstr ""
#: ../Doc/library/_winreg.rst:572
msgid "Reserved for system use."
msgstr ""
#: ../Doc/library/_winreg.rst:578
msgid "64-bit Specific"
msgstr ""
#: ../Doc/library/_winreg.rst:580
msgid ""
"For more information, see `Accessing an Alternate Registry View <http://msdn."
"microsoft.com/en-us/library/aa384129(v=VS.85).aspx>`__."
msgstr ""
#: ../Doc/library/_winreg.rst:585
msgid ""
"Indicates that an application on 64-bit Windows should operate on the 64-bit "
"registry view."
msgstr ""
#: ../Doc/library/_winreg.rst:590
msgid ""
"Indicates that an application on 64-bit Windows should operate on the 32-bit "
"registry view."
msgstr ""
#: ../Doc/library/_winreg.rst:597
msgid "Value Types"
msgstr ""
#: ../Doc/library/_winreg.rst:599
msgid ""
"For more information, see `Registry Value Types <http://msdn.microsoft.com/"
"en-us/library/ms724884%28v=VS.85%29.aspx>`__."
msgstr ""
#: ../Doc/library/_winreg.rst:604
msgid "Binary data in any form."
msgstr ""
#: ../Doc/library/_winreg.rst:608
msgid "32-bit number."
msgstr ""
#: ../Doc/library/_winreg.rst:612
msgid "A 32-bit number in little-endian format."
msgstr ""
#: ../Doc/library/_winreg.rst:616
msgid "A 32-bit number in big-endian format."
msgstr ""
#: ../Doc/library/_winreg.rst:620
msgid ""
"Null-terminated string containing references to environment variables (``"
"%PATH%``)."
msgstr ""
#: ../Doc/library/_winreg.rst:625
msgid "A Unicode symbolic link."
msgstr ""
#: ../Doc/library/_winreg.rst:629
msgid ""
"A sequence of null-terminated strings, terminated by two null characters. "
"(Python handles this termination automatically.)"
msgstr ""
#: ../Doc/library/_winreg.rst:634
msgid "No defined value type."
msgstr ""
#: ../Doc/library/_winreg.rst:638
msgid "A device-driver resource list."
msgstr ""
#: ../Doc/library/_winreg.rst:642
msgid "A hardware setting."
msgstr ""
#: ../Doc/library/_winreg.rst:646
msgid "A hardware resource list."
msgstr ""
#: ../Doc/library/_winreg.rst:650
msgid "A null-terminated string."
msgstr ""
#: ../Doc/library/_winreg.rst:656
msgid "Registry Handle Objects"
msgstr ""
#: ../Doc/library/_winreg.rst:658
msgid ""
"This object wraps a Windows HKEY object, automatically closing it when the "
"object is destroyed. To guarantee cleanup, you can call either the :meth:"
"`~PyHKEY.Close` method on the object, or the :func:`CloseKey` function."
msgstr ""
#: ../Doc/library/_winreg.rst:662
msgid "All registry functions in this module return one of these objects."
msgstr ""
#: ../Doc/library/_winreg.rst:664
msgid ""
"All registry functions in this module which accept a handle object also "
"accept an integer, however, use of the handle object is encouraged."
msgstr ""
#: ../Doc/library/_winreg.rst:667
msgid "Handle objects provide semantics for :meth:`__nonzero__` -- thus::"
msgstr ""
#: ../Doc/library/_winreg.rst:672
msgid ""
"will print ``Yes`` if the handle is currently valid (has not been closed or "
"detached)."
msgstr ""
#: ../Doc/library/_winreg.rst:675
msgid ""
"The object also support comparison semantics, so handle objects will compare "
"true if they both reference the same underlying Windows handle value."
msgstr ""
#: ../Doc/library/_winreg.rst:678
msgid ""
"Handle objects can be converted to an integer (e.g., using the built-in :"
"func:`int` function), in which case the underlying Windows handle value is "
"returned. You can also use the :meth:`~PyHKEY.Detach` method to return the "
"integer handle, and also disconnect the Windows handle from the handle "
"object."
msgstr ""
#: ../Doc/library/_winreg.rst:686
msgid "Closes the underlying Windows handle."
msgstr ""
#: ../Doc/library/_winreg.rst:688
msgid "If the handle is already closed, no error is raised."
msgstr ""
#: ../Doc/library/_winreg.rst:693
msgid "Detaches the Windows handle from the handle object."
msgstr ""
#: ../Doc/library/_winreg.rst:695
msgid ""
"The result is an integer (or long on 64 bit Windows) that holds the value of "
"the handle before it is detached. If the handle is already detached or "
"closed, this will return zero."
msgstr ""
#: ../Doc/library/_winreg.rst:699
msgid ""
"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."
msgstr ""
#: ../Doc/library/_winreg.rst:706
msgid ""
"The HKEY object implements :meth:`~object.__enter__` and :meth:`~object."
"__exit__` and thus supports the context protocol for the :keyword:`with` "
"statement::"
msgstr ""
#: ../Doc/library/_winreg.rst:713
msgid ""
"will automatically close *key* when control leaves the :keyword:`with` block."
msgstr ""