System.Win.Registry.TRegistry.ReadBinaryData
Delphi
function ReadBinaryData(const Name: string; var Buffer; BufSize: Integer): Integer;
C++
int __fastcall ReadBinaryData(const System::UnicodeString Name, void *Buffer, int BufSize);
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | System.Win.Registry.pas System.Win.Registry.hpp |
System.Win.Registry | TRegistry |
Description
Renvoie une valeur binaire provenant d'une valeur de donnée associée à la clé en cours.
ReadBinaryData permet de lire une valeur binaire à partir d'une valeur de donnée particulière associée à la clé en cours. Name désigne le nom de la valeur de donnée à lire. Buffer est la variable applicative dans laquelle les données du registre doivent être écrites. Buffer doit avoir une taille suffisante pour contenir toutes les données renvoyées. BufSize spécifie la taille de Buffer.
En cas de réussite, ReadBinaryData écrit la donnée requise dans Buffer et renvoie le nombre d'octets écrits. Si l'entrée de registre contient un type connu (tel qu'une chaîne), ReadBinaryData déclenche une exception.
Remarque : Les données binaires sont généralement une structure de données complexe (un enregistrement dans Delphi ou une structure dans C++). Il peut s'agir d'une icône ou d'une image bitmap, bien que Microsoft conseille de ne pas stocker d'objets graphiques dans le registre pour des raisons de performances.