System.Win.Registry.TRegistry.CreateKey
Delphi
function CreateKey(const Key: string): Boolean;
C++
bool __fastcall CreateKey(const System::UnicodeString Key);
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | System.Win.Registry.pas System.Win.Registry.hpp |
System.Win.Registry | TRegistry |
Description
Crée une nouvelle clé dans le registre.
CreateKey permet d'ajouter une nouvelle clé au registre. Key représente le nom de la clé à créer. Il peut s'agir d'un nom absolu ou d'un nom relatif. Une clé absolue commence par une barre oblique inverse (\) et est sous-clé de la clé racine. Une clé relative est sous-clé de la clé en cours.
CreateKey renvoie true si la création de la clé a pu s'effectuer correctement. En cas d'erreur, une exception est provoquée. Une tentative de création d'une clé qui existe déjà n'a aucun effet.
CreateKey ne crée que des clés non volatiles. Pour créer des clés volatiles sous Windows NT, appelez directement l'API Windows.
CreateKey crée des clés avec un droit d'accès KEY_ALL_ACCESS. Pour créer des clés avec un droit d'accès plus restreint, appelez directement l'API Windows.
Une clé créée par CreateKey n'a pas de valeurs. Pour définir la valeur des clés, utilisez la procédure WriteCurrency, WriteBinaryData, WriteBool, WriteDate, WriteDateTime, WriteFloat, WriteInteger, WriteString ou WriteTime.