System.Win.Registry.TRegistry.WriteBinaryData
Delphi
procedure WriteBinaryData(const Name: string; const Buffer; BufSize: Integer);
C++
void __fastcall WriteBinaryData(const System::UnicodeString Name, const void *Buffer, int BufSize);
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
procedure function |
public | System.Win.Registry.pas System.Win.Registry.hpp |
System.Win.Registry | TRegistry |
Description
Ecrit une valeur de donnée associée à la clé en cours.
WriteBinaryData permet de stocker une valeur de donnée associée à la clé en cours.
Name est une chaîne contenant le nom de la valeur de donnée dans laquelle l'information doit être stockée. Si Name existe déjà, son contenu est écrasé par WriteBinary. Si elle n'existe pas, elle est créée.
Buffer est un tampon contenant les données à stocker dans le registre. BufSize indique la taille de Buffer.
Remarque : Les longueurs des valeurs de données sont limitées par la mémoire disponible. Les valeurs longues (plus de 2048 octets) doivent être stockées en tant que fichiers séparés et leurs noms de fichiers doivent être stockés dans le registre. Les éléments d'applications tels que les icônes, les images bitmap et les fichiers exécutables doivent être stockés en tant que fichiers séparés plutôt que sous forme de valeurs du registre.
Si WriteBinaryData échoue, une exception est provoquée et la valeur n'est pas écrite dans le registre.