RegDeleteKey

レジストリからサブキーを削除します。

RegDeleteKey KeyName

パラメータ

KeyName

型:文字列

レジストリキーのフルネームです。例:"HKLM\Software\SomeApplication"

キーは、HKEY_LOCAL_MACHINE(または HKLM)、HKEY_USERS(または HKU)、HKEY_CURRENT_USER(または HKCU)、HKEY_CLASSES_ROOT(または HKCR)、またはHKEY_CURRENT_CONFIG(または HKCC)で始まらなければなりません。

リモートレジストリにアクセスするには、"\\workstation01\HKLM"のようにコンピューター名とバックスラッシュを前に追加してください。

KeyNameレジストリループが実行されている場合のみ省略可能で、その場合、現在のループアイテムのキーがデフォルトとなります。項目がサブキーのときは、デフォルトでそのサブキーのフルネームが使用されます。

エラー処理

失敗したときはOSErrorをスローします。

A_LastErrorには、オペレーティングシステムのGetLastError()関数の結果が設定されます。

備考

警告: レジストリからキーを削除することは危険を伴うことがあります。慎重に実行してください!

複数のレジストリキーや値を取得し、操作するためにはレジストリループの利用を検討してください。

レジストリループ内では、RegDeleteKeyは必ずしも現在のループ項目を削除するわけではありません。項目がサブキーのときは、RegDeleteKey()はそのサブキーそのものを削除します。項目が値とのときは、RegDeleteKey()はその値を含むキーをサブキーを含めて全て削除します。

リモートコンピュータのレジストリにアクセスする方法については、レジストリループの備考をご覧ください。

32ビットスクリプトでレジストリの64ビットセクションのエントリを削除する場合、またはその逆の場合は、SetRegView関数を使用します。

RegCreateKeyRegDeleteRegReadRegWriteレジストリループSetRegViewIniDelete

レジストリからサブキーを削除します。

RegDeleteKey "HKEY_LOCAL_MACHINE\Software\SomeApplication"