Reg_LoadHive

Owned by Martin Gudme Søndergaard
May 23, 2022

Reg_LoadHive(sTempHive,sFile)

Loads an off-line hive into a temp hive in the current registry, so it can be manipulated using the normal registry functions found in the CapaInstaller Scripting Library.

Arguments

ARGUMENT

DESCRIPTION

TYPE

sTempHive

The temporary hive name that will hold the reference to the loaded hive

String

sFile

The full path to the hive file that is to be loaded

String

Return Type

Boolean, TRUE if function completed successfully.

Remarks

(warning) It is important to unload the hive again after making changes, otherwise it can become corrupted.

Example

The following example will load the HKLM\Software hive from the old operating system to HKLM\TempHive, and the attempt to read the old computer name.

Private Function IncludeScript(sScriptFile)
 '...
End Function

'Begin
  bStatus=True
  If bStatus Then bStatus=IncludeScript("customlib.cis")
  If bStatus Then bStatus=IncludeLibrary("Capalib.cin")
  If bStatus Then bStatus=IncludeLibrary("Osdlib.cin")
  If bStatus Then bStatus=Job_Start("WS","Script Name","1.0","ScriptName.log","INSTALL")
  If bStatus Then bStatus=OSD_Initialize()

  If bStatus Then bStatus=Reg_LoadHive("HKLM\TempHive","C:\Windows\System32\config\software")
  If bStatus Then bStatus=Reg_GetString("HKLM","TempHive\CapaSystems\CapaInstaller\Client","ComputerName",False)
  If bStatus and gsValue <> "" Then 
    bStatus=Dialog_ShowInformation("The old computer name is: " & gsValue)
  Else
    bStatus=Dialog_ShowInformation("The old computer name could not be found")
  End If
  If bStatus Then bStatus=Reg_UnLoadHive("HKLM\TempHive")

  Job_End(bStatus)
'End main

See Also

IncludeScript function, Reg_UnloadHive, Dialog_ShowInformation