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);
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
procedure function |
public | System.Win.Registry.pas System.Win.Registry.hpp |
System.Win.Registry | TRegistry |
Beschreibung
Speichert einen benannten Datenwert, der dem aktuellen Schlüssel zugeordnet ist.
Mit WriteBinaryData wird ein Datenwert gespeichert, der dem aktuellen Schlüssel zugeordnet ist.
Name ist ein String, der den Namen des Datenwertes enthält, in dem die Daten gespeichert werden sollen. Ist der Name bereits vorhanden, wird dessen Wert überschrieben. Existiert Name noch nicht, wird er angelegt.
Der Parameter Buffer ist ein Datenpuffer, der alles enthält, was in der Registrierung gespeichert werden soll. Die Größe des Puffers wird mit BufSize angegeben.
Anmerkung: Die Länge von Datenwerten wird nur durch den verfügbaren Speicher begrenzt. Werte mit mehr als 2048 Byte sollten allerdings als separate Dateien gespeichert werden, von denen dann nur der Name in der Registrierung hinterlegt wird. Anwendungskomponenten, wie Symbole, Bitmaps und ausführbare Dateien sollten auf jeden Fall als eigene Dateien gespeichert werden.
Wenn die Ausführung von WriteBinaryData fehlschlägt, wird eine Exception ausgelöst, und der Wert gelangt nicht in die Registrierung.