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));
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
procedure function |
public | System.Win.ComObj.pas System.Win.ComObj.hpp |
System.Win.ComObj | System.Win.ComObj |
Description
Crée ou ouvre une clé de base de registres qui est la clé secondaire de HKEY_CLASSES_ROOT.
CreateRegKey crée ou ouvre la clé spécifiée par le paramètre Key. Si la clé n'existe pas dans la base de registres, CreateRegKey la crée, sinon CreateRegKey l'ouvre.
Remarque : CreateRegKey est utile pour l'implémentation de la méthode UpdateRegistry d'une fabrique de classes.
Key spécifie une chaîne qui ne doit pas commencer par le caractère '\'. Elle doit être une clé secondaire de RootKey.
Lorsque la clé est créée, une autre valeur et d'autres informations de type pour la clé spécifiée peuvent être définies depuis les paramètres passés à CreateRegKey.
ValueName pointe sur une chaîne spécifiant le nom de la clé associée.
Value spécifie les données à stocker avec le nom de valeur spécifié.
RootKey est la clé de registre de niveau supérieur sous laquelle le nouvelle clé est crée ou ouverte. Si elle est omise, c'est HKEY_CLASSES_ROOT.
Si CreateRegKey ne réussit pas, une exception EOleRegistrationError est déclenchée.