/AutoHotkey.docset/Contents/Resources/Documents/commands/SetRegView.htm

https://gitlab.com/ahkscript/Autohotkey.docset · HTML · 68 lines · 54 code · 14 blank · 0 comment · 0 complexity · 893a0174670e1a52e7817792660e18b1 MD5 · raw file 

    

  1. <!DOCTYPE HTML>
    2. 

  2. <html>
    3. 

  3. <head>
    4. 

  4. <title>SetRegView</title>
    5. 

  5. <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
    6. 

  6. <meta http-equiv="X-UA-Compatible" content="IE=edge">
    7. 

  7. <link href="../static/theme.css" rel="stylesheet" type="text/css" />
    8. 

  8. <script src="../static/content.js" type="text/javascript"></script>
    9. 

  9. </head>
    10. 

  10. <body>
    11. 

  11. 

  12. <h1>SetRegView <span class="ver">[v1.1.08+]</span></h1>
    13. 

  13. <p>Sets the registry view used by RegRead, RegWrite, RegDelete and registry loops.</p>
    14. 

  14. <pre class="Syntax">SetRegView, RegView</pre>
    15. 

  15. 

  16. <h3>Parameters</h3>
    17. 

  17. <dl>
    18. 

  18. 

  19.   <dt>RegView</dt>
    20. 

  20.   <dd>
    21. 

  21.       <p>Specify <strong>32</strong> to view the registry as a 32-bit application would, or <strong>64</strong> to view the registry as a 64-bit application would.</p>
    22. 

  22.       <p>Specify the word <strong>Default</strong> to restore normal behaviour.</p>
    23. 

  23.     </dd>
    24. 

  24. 

  25. </dl>
    26. 

  26. 

  27. <h3>General Remarks</h3>
    28. 

  28. <p>This command is only useful on Windows 64-bit.  It has no effect on Windows 32-bit.</p>
    29. 

  29. <p>On 64-bit systems, 32-bit applications run on a subsystem of Windows called <a href="http://msdn.microsoft.com/en-us/library/aa384249">WOW64</a>.  By default, the system redirects certain <a href="http://msdn.microsoft.com/en-us/library/aa384253">registry keys</a> to prevent conflicts.  For example, in a 32-bit script, <code>HKLM\SOFTWARE\AutoHotkey</code> is redirected to <code>HKLM\SOFTWARE\Wow6432Node\AutoHotkey</code>.  SetRegView allows the registry commands in a 32-bit script to access redirected keys in the 64-bit registry view and vice versa.</p>
    30. 

  30. 

  31. <p>The built-in variable <em>A_RegView</em> contains the current setting.  Every newly launched <a href="../misc/Threads.htm">thread</a> (such as a <a href="../Hotkeys.htm">hotkey</a>, <a href="Menu.htm">custom menu item</a>, or <a href="SetTimer.htm">timed</a> subroutine) starts off fresh with the default setting for this command. That default may be changed by using this command in the auto-execute section (top part of the script).</p>
    32. 

  32. 

  33. <h3>Related</h3>
    34. 

  34. <p><a href="RegRead.htm">RegRead</a>, <a href="RegWrite.htm">RegWrite</a>, <a href="RegDelete.htm">RegDelete</a>, <a href="LoopReg.htm">Loop (registry)</a></p>
    35. 

  35. 

  36. <h3>Examples</h3>
    37. 

  37. <p id="example1">Example 1 shows how to set a specific registry view, and how registry redirection affects the script.</p>
    38. 

  38. <pre><em>; Access the registry as a 32-bit application would.</em>
    39. 

  39. SetRegView 32
    40. 

  40. RegWrite REG_SZ, HKLM, SOFTWARE\Test.ahk, Value, 123
    41. 

  41. 

  42. <em>; Access the registry as a 64-bit application would.</em>
    43. 

  43. SetRegView 64
    44. 

  44. RegRead value, HKLM, SOFTWARE\Wow6432Node\Test.ahk, Value
    45. 

  45. RegDelete HKLM, SOFTWARE\Wow6432Node\Test.ahk
    46. 

  46. 

  47. MsgBox Read value '%value%' via Wow6432Node.
    48. 

  48. 

  49. <em>; Restore the registry view to the default, which
    50. 

  50. ; depends on whether the script is 32-bit or 64-bit.</em>
    51. 

  51. SetRegView Default
    52. 

  52. <em>;...</em>
    53. 

  53. </pre>
    54. 

  54. <p id="example2">Example 2 shows how to detect the type of EXE and operating system on which the script is running.</p>
    55. 

  55. <pre>if (A_PtrSize = 8)
    56. 

  56.     script_is := "64-bit"
    57. 

  57. else <em>; if (A_PtrSize = 4)</em>
    58. 

  58.     script_is := "32-bit"
    59. 

  59. 

  60. if (A_Is64bitOS)
    61. 

  61.     OS_is := "64-bit"
    62. 

  62. else
    63. 

  63.     OS_is := "32-bit, which has only a single registry view"
    64. 

  64. 

  65. MsgBox This script is %script_is%, and the OS is %OS_is%.</pre>
    66. 

  66. 

  67. </body>
    68. 

  68. </html>
    69.