Ruby 2.1.0 リファレンスマニュアル > ライブラリ一覧 > win32/registryライブラリ

library win32/registry

要約

win32/registry は Win32 プラットフォームでレジストリをアクセスするための ライブラリです。Win32 API の呼び出しに Win32API を使います。

Win32::Registry::HKEY_CURRENT_USER.open('SOFTWARE\foo') do |reg|
 value = reg['foo'] # 値の読み込み
 value = reg['foo', Win32::Registry::REG_SZ] # 型を限定した読み込み
 type, value = reg.read('foo') # 値の読み込み
 reg['foo'] = 'bar' # 値の書き込み
 reg['foo', Win32::Registry::REG_SZ] = 'bar' # 型指定付き値の書き込み
 reg.write('foo', Win32::Registry::REG_SZ, 'bar') # 値の書き込み
 reg.each_value { |name, type, data| ... } # 値の列挙
 reg.each_key { |key, wtime| ... } # サブキーの列挙
 reg.delete_value('foo') # 値の削除
 reg.delete_key('foo') # サブキーの削除
 reg.delete_key('foo', true) # サブキーの再帰削除
end

WSH を用いたレジストリアクセス

レジストリをアクセスするには WIN32OLE を使って WScript.Shell オブジェクト経由でアクセスする方法もあります。

wsh = WIN32OLE.new('WScript.Shell')
value = wsh.RegRead 'HKLM\Software\Microsoft\Windows\...'
wsh.RegWrite 'HKCR\foofile\shell\open\command\', 'REG_SZ', '"C:\..." "%1"'

ただし,キーを列挙したり,自由なバイナリ値を読み書きすることができません。

クラス

Win32::Registry
Win32::Registry::PredefinedKey

モジュール

Win32::Registry::API
Win32::Registry::Constants

詳細は以下の MSDN Library を参照してください。

例外クラス

Win32::Registry::Error

AltStyle によって変換されたページ (->オリジナル) /