1.2.159 RegDBCreateKeyEx – Schlüssel in der Registry anlegen
RegDBCreateKeyEx (strKey,strClass);
|
Argumente
|
strKey
Schlüssel, der angelegt werden soll
|
|
|
strClass
optionale Klasse, die mit dem Schlüssel assoziiert werden soll
|
|
Rückgabewert
|
Fehlerhandling übernimmt die InstallEngine.
|
|
Beschreibung
|
Die Funktion RegDBCreateKeyEx erzeugt einen Schlüssel im Registry.
Sie können dem neu erzeugten Schlüssel auch ein Klassenobjekt zuweisen (nur für fortgeschrittene Anwender).
Der neu erzeugte Schlüssel verfügt noch über keinen zugehörigen Wert. Sofern Sie dies nicht anderweitig definieren, erzeugt InstallShield den Schlüssel als einen Teilschlüssel von HKEY_CLASSES_ROOT.
Sie können mit der Funktion RegDBSetDefaultRoot einen anderen Stammschlüssel definieren.
Trennen Sie die verschiedenen Ebenen eines Schlüssel-Teilschlüssel-Ausdrucks mit zwei Backslashes (\\).
Falls sie nicht bereits vorhanden sind, werden die Ebenen von InstallShield sofort erzeugt.
Mit RegDBCreateKeyEx erzeugte Schlüssel werden von unInstallShield für die Deinstallation protokolliert, wenn die Protokollierung aktiviert ist.
Beachten Sie jedoch, dass in Ausdrücken mit mehreren Schlüsseln, z. B. Key1\Key2\Key3, die Funktion RegDBCreateKeyEx den Schlüssel Key3 als relevanten Schlüssel für diesen Funktionsaufruf erkennt, genauso wie der DOS-Befehl DIR C:\Windows\System die Dateien im Systemverzeichnis und nicht im Windows-Verzeichnis auflistet.
Daher wird Key3 für die Deinstallation protokolliert, nicht jedoch Key1 und Key2.
Um eine korrekte Deinstallationsprotokollierung sicherzustellen, wenn ein Schlüssel und Teilschlüssels mit RegDBCreateKeyEx erzeugt wird, erzeugen Sie zunächst den Elternschlüssel (mit aktivierter Protokollierung).
Nachdem der Eltern- oder übergeordnete Schlüssel in der Schlüsselkette erzeugt wurde, erzeugen Sie als nächstes die Teilschlüssel unterhalb des betreffenden Elternschlüssels.
Alle Teilschlüssel des individuell erzeugten Elternschlüssels werden deinstalliert, wenn der Elternschlüssel deinstalliert wird.
|
|
Weiter Beschreibung
|
Um z. B. sicherzustellen, dass Key1 und alle seine Teilschlüssel deinstalliert werden, erzeugen Sie zunächst Key1 mit der Funktion RegDBCreateKeyEx, wobei die Protokollierung aktiviert ist.
Anschließend können Sie Key2, Key3 usw. in einem einzigen Funktionsaufruf oder in getrennten Aufrufen erzeugen. Wenn Key1 deinstalliert wird, werden auch alle seine Teilschlüssel deinstalliert.
Beachten Sie, dass bei der Deinstallation eines Schlüssels alle seine Teilschlüssel ebenfalls entfernt werden.
Wenn Sie also mit RegDBCreateKeyEx einen oder mehrere Schlüssel unterhalb eines Schlüssels erzeugen, der bereits für die Deinstallation protokolliert ist, werden die erzeugten Schlüssel bei der Deinstallation des übergeordneten Schlüssels deinstalliert; dies ist unabhängig davon, ob bei der Erzeugung der Schlüssel die Protokollierung aktiviert ist und auch unabhängig von der Reihenfolge, in der Sie die Schlüssel erzeugen.
|
|
Funktionsart
|
infraSetupFunktion
|