# SOME DESCRIPTIVE TITLE. # Copyright (C) 2001-2016, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2016-10-30 10:40+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \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:12 msgid "" "These functions expose the Windows registry API to Python. Instead of using " "an integer as the registry handle, a :ref:`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:19 msgid "" "Several functions in this module used to raise a :exc:`WindowsError`, which " "is now an alias of :exc:`OSError`." msgstr "" #: ../Doc/library/winreg.rst:26 msgid "Functions" msgstr "Fonctions" #: ../Doc/library/winreg.rst:28 msgid "This module offers the following functions:" msgstr "" #: ../Doc/library/winreg.rst:33 msgid "" "Closes a previously opened registry key. The *hkey* argument specifies a " "previously opened key." msgstr "" #: ../Doc/library/winreg.rst:38 msgid "" "If *hkey* is not closed using this method (or via :meth:`hkey.Close() " "`), it is closed when the *hkey* object is destroyed by Python." msgstr "" #: ../Doc/library/winreg.rst:45 msgid "" "Establishes a connection to a predefined registry handle on another " "computer, and returns a :ref:`handle object `." msgstr "" #: ../Doc/library/winreg.rst:48 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:51 msgid "*key* is the predefined handle to connect to." msgstr "" #: ../Doc/library/winreg.rst:53 ../Doc/library/winreg.rst:75 #: ../Doc/library/winreg.rst:103 msgid "" "The return value is the handle of the opened key. If the function fails, an :" "exc:`OSError` exception is raised." msgstr "" #: ../Doc/library/winreg.rst:56 ../Doc/library/winreg.rst:78 #: ../Doc/library/winreg.rst:108 ../Doc/library/winreg.rst:127 #: ../Doc/library/winreg.rst:163 ../Doc/library/winreg.rst:190 #: ../Doc/library/winreg.rst:223 ../Doc/library/winreg.rst:303 msgid "See :ref:`above `." msgstr "" #: ../Doc/library/winreg.rst:62 ../Doc/library/winreg.rst:84 msgid "" "Creates or opens the specified key, returning a :ref:`handle object `." msgstr "" #: ../Doc/library/winreg.rst:65 ../Doc/library/winreg.rst:87 #: ../Doc/library/winreg.rst:116 ../Doc/library/winreg.rst:141 #: ../Doc/library/winreg.rst:171 ../Doc/library/winreg.rst:181 #: ../Doc/library/winreg.rst:198 ../Doc/library/winreg.rst:240 #: ../Doc/library/winreg.rst:285 ../Doc/library/winreg.rst:311 #: ../Doc/library/winreg.rst:335 ../Doc/library/winreg.rst:353 #: ../Doc/library/winreg.rst:375 ../Doc/library/winreg.rst:398 #: ../Doc/library/winreg.rst:424 ../Doc/library/winreg.rst:453 #: ../Doc/library/winreg.rst:468 ../Doc/library/winreg.rst:481 msgid "" "*key* is an already open key, or one of the predefined :ref:`HKEY_* " "constants `." msgstr "" #: ../Doc/library/winreg.rst:68 ../Doc/library/winreg.rst:90 msgid "*sub_key* is a string that names the key this method opens or creates." msgstr "" #: ../Doc/library/winreg.rst:70 ../Doc/library/winreg.rst:98 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:73 ../Doc/library/winreg.rst:101 msgid "If the key already exists, this function opens the existing key." msgstr "" #: ../Doc/library/winreg.rst:92 ../Doc/library/winreg.rst:148 msgid "" "*reserved* is a reserved integer, and must be zero. The default is zero." msgstr "" #: ../Doc/library/winreg.rst:94 msgid "" "*access* is an integer that specifies an access mask that describes the " "desired security access for the key. Default is :const:`KEY_WRITE`. See :" "ref:`Access Rights ` for other allowed values." msgstr "" #: ../Doc/library/winreg.rst:114 ../Doc/library/winreg.rst:133 msgid "Deletes the specified key." msgstr "" #: ../Doc/library/winreg.rst:119 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:122 ../Doc/library/winreg.rst:154 msgid "*This method can not delete keys with subkeys.*" msgstr "" #: ../Doc/library/winreg.rst:124 ../Doc/library/winreg.rst:156 msgid "" "If the method succeeds, the entire key, including all of its values, is " "removed. If the method fails, an :exc:`OSError` exception is raised." msgstr "" #: ../Doc/library/winreg.rst:136 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 `__." msgstr "" #: ../Doc/library/winreg.rst:144 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:150 msgid "" "*access* 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 ` for other allowed values." msgstr "" #: ../Doc/library/winreg.rst:159 msgid "On unsupported Windows versions, :exc:`NotImplementedError` is raised." msgstr "" #: ../Doc/library/winreg.rst:169 msgid "Removes a named value from a registry key." msgstr "" #: ../Doc/library/winreg.rst:174 msgid "*value* is a string that identifies the value to remove." msgstr "" #: ../Doc/library/winreg.rst:179 msgid "Enumerates subkeys of an open registry key, returning a string." msgstr "" #: ../Doc/library/winreg.rst:184 msgid "*index* is an integer that identifies the index of the key to retrieve." msgstr "" #: ../Doc/library/winreg.rst:186 msgid "" "The function retrieves the name of one subkey each time it is called. It is " "typically called repeatedly until an :exc:`OSError` exception is raised, " "indicating, no more values are available." msgstr "" #: ../Doc/library/winreg.rst:196 msgid "Enumerates values of an open registry key, returning a tuple." msgstr "" #: ../Doc/library/winreg.rst:201 msgid "" "*index* is an integer that identifies the index of the value to retrieve." msgstr "" #: ../Doc/library/winreg.rst:203 msgid "" "The function retrieves the name of one subkey each time it is called. It is " "typically called repeatedly, until an :exc:`OSError` exception is raised, " "indicating no more values." msgstr "" #: ../Doc/library/winreg.rst:207 ../Doc/library/winreg.rst:314 msgid "The result is a tuple of 3 items:" msgstr "" #: ../Doc/library/winreg.rst:210 ../Doc/library/winreg.rst:317 #: ../Doc/library/winreg.rst:361 msgid "Index" msgstr "" #: ../Doc/library/winreg.rst:210 ../Doc/library/winreg.rst:317 #: ../Doc/library/winreg.rst:361 msgid "Meaning" msgstr "Signification" #: ../Doc/library/winreg.rst:212 ../Doc/library/winreg.rst:319 #: ../Doc/library/winreg.rst:363 msgid "``0``" msgstr "``0``" #: ../Doc/library/winreg.rst:212 msgid "A string that identifies the value name" msgstr "" #: ../Doc/library/winreg.rst:214 ../Doc/library/winreg.rst:322 #: ../Doc/library/winreg.rst:365 msgid "``1``" msgstr "``1``" #: ../Doc/library/winreg.rst:214 msgid "" "An object that holds the value data, and whose type depends on the " "underlying registry type" msgstr "" #: ../Doc/library/winreg.rst:218 ../Doc/library/winreg.rst:325 msgid "``2``" msgstr "``2``" #: ../Doc/library/winreg.rst:218 msgid "" "An integer that identifies the type of the value data (see table in docs " "for :meth:`SetValueEx`)" msgstr "" #: ../Doc/library/winreg.rst:229 msgid "" "Expands environment variable placeholders ``%NAME%`` in strings like :const:" "`REG_EXPAND_SZ`::" msgstr "" #: ../Doc/library/winreg.rst:238 msgid "Writes all the attributes of a key to the registry." msgstr "" #: ../Doc/library/winreg.rst:243 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:252 msgid "" "If you don't know whether a :func:`FlushKey` call is required, it probably " "isn't." msgstr "" #: ../Doc/library/winreg.rst:258 msgid "" "Creates a subkey under the specified key and stores registration information " "from a specified file into that subkey." msgstr "" #: ../Doc/library/winreg.rst:261 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:264 msgid "*sub_key* is a string that identifies the subkey to load." msgstr "" #: ../Doc/library/winreg.rst:266 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:270 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 `__ for more details." msgstr "" #: ../Doc/library/winreg.rst:276 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:283 msgid "" "Opens the specified key, returning a :ref:`handle object `." msgstr "" #: ../Doc/library/winreg.rst:288 msgid "*sub_key* is a string that identifies the sub_key to open." msgstr "" #: ../Doc/library/winreg.rst:290 msgid "" "*reserved* is a reserved integer, and must be zero. The default is zero." msgstr "" #: ../Doc/library/winreg.rst:292 msgid "" "*access* 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 ` for other allowed values." msgstr "" #: ../Doc/library/winreg.rst:296 msgid "The result is a new handle to the specified key." msgstr "" #: ../Doc/library/winreg.rst:298 msgid "If the function fails, :exc:`OSError` is raised." msgstr "" #: ../Doc/library/winreg.rst:300 msgid "Allow the use of named arguments." msgstr "" #: ../Doc/library/winreg.rst:309 msgid "Returns information about a key, as a tuple." msgstr "" #: ../Doc/library/winreg.rst:319 msgid "An integer giving the number of sub keys this key has." msgstr "" #: ../Doc/library/winreg.rst:322 msgid "An integer giving the number of values this key has." msgstr "" #: ../Doc/library/winreg.rst:325 msgid "" "An integer giving when the key was last modified (if available) as 100's of " "nanoseconds since Jan 1, 1601." msgstr "" #: ../Doc/library/winreg.rst:333 msgid "Retrieves the unnamed value for a key, as a string." msgstr "" #: ../Doc/library/winreg.rst:338 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:342 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:350 msgid "" "Retrieves the type and data for a specified value name associated with an " "open registry key." msgstr "" #: ../Doc/library/winreg.rst:356 msgid "*value_name* is a string indicating the value to query." msgstr "" #: ../Doc/library/winreg.rst:358 msgid "The result is a tuple of 2 items:" msgstr "" #: ../Doc/library/winreg.rst:363 msgid "The value of the registry item." msgstr "" #: ../Doc/library/winreg.rst:365 msgid "" "An integer giving the registry type for this value (see table in docs for :" "meth:`SetValueEx`)" msgstr "" #: ../Doc/library/winreg.rst:373 msgid "Saves the specified key, and all its subkeys to the specified file." msgstr "" #: ../Doc/library/winreg.rst:378 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:383 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 `__ for more details." msgstr "" #: ../Doc/library/winreg.rst:391 msgid "This function passes NULL for *security_attributes* to the API." msgstr "" #: ../Doc/library/winreg.rst:396 msgid "Associates a value with a specified key." msgstr "" #: ../Doc/library/winreg.rst:401 msgid "" "*sub_key* is a string that names the subkey with which the value is " "associated." msgstr "" #: ../Doc/library/winreg.rst:403 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:407 ../Doc/library/winreg.rst:435 msgid "*value* is a string that specifies the new value." msgstr "" #: ../Doc/library/winreg.rst:409 msgid "" "If the key specified by the *sub_key* parameter does not exist, the SetValue " "function creates it." msgstr "" #: ../Doc/library/winreg.rst:412 ../Doc/library/winreg.rst:443 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:416 msgid "" "The key identified by the *key* parameter must have been opened with :const:" "`KEY_SET_VALUE` access." msgstr "" #: ../Doc/library/winreg.rst:422 msgid "Stores data in the value field of an open registry key." msgstr "" #: ../Doc/library/winreg.rst:427 msgid "" "*value_name* is a string that names the subkey with which the value is " "associated." msgstr "" #: ../Doc/library/winreg.rst:430 msgid "*reserved* can be anything -- zero is always passed to the API." msgstr "" #: ../Doc/library/winreg.rst:432 msgid "" "*type* is an integer that specifies the type of the data. See :ref:`Value " "Types ` for the available types." msgstr "" #: ../Doc/library/winreg.rst:437 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:441 msgid "To open the key, use the :func:`CreateKey` or :func:`OpenKey` methods." msgstr "" #: ../Doc/library/winreg.rst:450 msgid "" "Disables registry reflection for 32-bit processes running on a 64-bit " "operating system." msgstr "" #: ../Doc/library/winreg.rst:456 ../Doc/library/winreg.rst:471 #: ../Doc/library/winreg.rst:486 msgid "" "Will generally raise :exc:`NotImplemented` if executed on a 32-bit operating " "system." msgstr "" #: ../Doc/library/winreg.rst:459 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:466 msgid "Restores registry reflection for the specified disabled key." msgstr "" #: ../Doc/library/winreg.rst:474 msgid "" "Restoring reflection for a key does not affect reflection of any subkeys." msgstr "" #: ../Doc/library/winreg.rst:479 msgid "Determines the reflection state for the specified key." msgstr "" #: ../Doc/library/winreg.rst:484 msgid "Returns ``True`` if reflection is disabled." msgstr "" #: ../Doc/library/winreg.rst:493 msgid "Constants" msgstr "Constantes" #: ../Doc/library/winreg.rst:495 msgid "" "The following constants are defined for use in many :mod:`_winreg` functions." msgstr "" #: ../Doc/library/winreg.rst:500 msgid "HKEY_* Constants" msgstr "" #: ../Doc/library/winreg.rst:504 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:511 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:518 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:524 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:530 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:538 msgid "" "Contains information about the current hardware profile of the local " "computer system." msgstr "" #: ../Doc/library/winreg.rst:543 msgid "This key is not used in versions of Windows after 98." msgstr "" #: ../Doc/library/winreg.rst:549 msgid "Access Rights" msgstr "" #: ../Doc/library/winreg.rst:551 msgid "" "For more information, see `Registry Key Security and Access `__." msgstr "" #: ../Doc/library/winreg.rst:556 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:563 msgid "" "Combines the STANDARD_RIGHTS_WRITE, :const:`KEY_SET_VALUE`, and :const:" "`KEY_CREATE_SUB_KEY` access rights." msgstr "" #: ../Doc/library/winreg.rst:568 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:573 msgid "Equivalent to :const:`KEY_READ`." msgstr "" #: ../Doc/library/winreg.rst:577 msgid "Required to query the values of a registry key." msgstr "" #: ../Doc/library/winreg.rst:581 msgid "Required to create, delete, or set a registry value." msgstr "" #: ../Doc/library/winreg.rst:585 msgid "Required to create a subkey of a registry key." msgstr "" #: ../Doc/library/winreg.rst:589 msgid "Required to enumerate the subkeys of a registry key." msgstr "" #: ../Doc/library/winreg.rst:593 msgid "" "Required to request change notifications for a registry key or for subkeys " "of a registry key." msgstr "" #: ../Doc/library/winreg.rst:598 msgid "Reserved for system use." msgstr "" #: ../Doc/library/winreg.rst:604 msgid "64-bit Specific" msgstr "" #: ../Doc/library/winreg.rst:606 msgid "" "For more information, see `Accessing an Alternate Registry View `__." msgstr "" #: ../Doc/library/winreg.rst:611 msgid "" "Indicates that an application on 64-bit Windows should operate on the 64-bit " "registry view." msgstr "" #: ../Doc/library/winreg.rst:616 msgid "" "Indicates that an application on 64-bit Windows should operate on the 32-bit " "registry view." msgstr "" #: ../Doc/library/winreg.rst:623 msgid "Value Types" msgstr "" #: ../Doc/library/winreg.rst:625 msgid "" "For more information, see `Registry Value Types `__." msgstr "" #: ../Doc/library/winreg.rst:630 msgid "Binary data in any form." msgstr "" #: ../Doc/library/winreg.rst:634 msgid "32-bit number." msgstr "" #: ../Doc/library/winreg.rst:638 msgid "" "A 32-bit number in little-endian format. Equivalent to :const:`REG_DWORD`." msgstr "" #: ../Doc/library/winreg.rst:642 msgid "A 32-bit number in big-endian format." msgstr "" #: ../Doc/library/winreg.rst:646 msgid "" "Null-terminated string containing references to environment variables (``" "%PATH%``)." msgstr "" #: ../Doc/library/winreg.rst:651 msgid "A Unicode symbolic link." msgstr "" #: ../Doc/library/winreg.rst:655 msgid "" "A sequence of null-terminated strings, terminated by two null characters. " "(Python handles this termination automatically.)" msgstr "" #: ../Doc/library/winreg.rst:660 msgid "No defined value type." msgstr "" #: ../Doc/library/winreg.rst:664 msgid "A 64-bit number." msgstr "" #: ../Doc/library/winreg.rst:670 msgid "" "A 64-bit number in little-endian format. Equivalent to :const:`REG_QWORD`." msgstr "" #: ../Doc/library/winreg.rst:676 msgid "A device-driver resource list." msgstr "" #: ../Doc/library/winreg.rst:680 msgid "A hardware setting." msgstr "" #: ../Doc/library/winreg.rst:684 msgid "A hardware resource list." msgstr "" #: ../Doc/library/winreg.rst:688 msgid "A null-terminated string." msgstr "" #: ../Doc/library/winreg.rst:694 msgid "Registry Handle Objects" msgstr "" #: ../Doc/library/winreg.rst:696 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:700 msgid "All registry functions in this module return one of these objects." msgstr "" #: ../Doc/library/winreg.rst:702 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:705 msgid "Handle objects provide semantics for :meth:`__bool__` -- thus ::" msgstr "" #: ../Doc/library/winreg.rst:710 msgid "" "will print ``Yes`` if the handle is currently valid (has not been closed or " "detached)." msgstr "" #: ../Doc/library/winreg.rst:713 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:716 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:724 msgid "Closes the underlying Windows handle." msgstr "" #: ../Doc/library/winreg.rst:726 msgid "If the handle is already closed, no error is raised." msgstr "" #: ../Doc/library/winreg.rst:731 msgid "Detaches the Windows handle from the handle object." msgstr "" #: ../Doc/library/winreg.rst:733 msgid "" "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." msgstr "" #: ../Doc/library/winreg.rst:737 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:744 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:751 msgid "" "will automatically close *key* when control leaves the :keyword:`with` block." msgstr ""