System.Win.ComObj.CreateRegKey
Delphi
procedure CreateRegKey(const Key, ValueName, Value: string; RootKey: HKEY);
C++
extern DELPHI_PACKAGE void __fastcall CreateRegKey(const System::UnicodeString Key, const System::UnicodeString ValueName, const System::UnicodeString Value, HKEY RootKey = (HKEY)(0x80000000));
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
procedure function |
public | System.Win.ComObj.pas System.Win.ComObj.hpp |
System.Win.ComObj | System.Win.ComObj |
Beschreibung
Erstellt oder öffnet einen Registrierungsschlüssel als Unterschlüssel von HKEY_CLASSES_ROOT.
CreateRegKey erzeugt oder öffnet den Schlüssel, der im Parameter Key angegeben ist. Wenn der Schlüssel noch nicht in der Registrierung vorhanden ist, wird er von CreateRegKey erzeugt, andernfalls geöffnet.
Anmerkung: Dies ist für die Implementierung der Methode UpdateRegistry eines Klassengenerators wichtig.
Key legt einen String fest, der nicht mit dem Backslash-Zeichen ('\') beginnen darf. Dieser muss ein Unterschlüssel von RootKey sein.
Wenn der Schlüssel erzeugt wird, können mithilfe der an CreateRegKey übergebenen Parameter zusätzliche Informationen über den Wert und den Typ des Schlüssels festgelegt werden.
ValueName zeigt auf einen String, der den Namen des zugehörigen Unterschlüssels angibt.
Value gibt die Daten an, die mit dem angegebenen Wertnamen gespeichert werden sollen.
RootKey ist der Registrierungsschlüssel der obersten Ebene, unter dem der neue Schlüssel erstellt und geöffnet wird. Fehlt die Angabe, ist dies HKEY_CLASSES_ROOT.
Wenn CreateRegKey fehlschlägt, wird eine EOleRegistrationError-Exception ausgelöst.