System.Win.Registry.TRegistry.WriteBinaryData
Delphi
procedure WriteBinaryData(const Name: string; var Buffer; BufSize: Integer);
C++
void __fastcall WriteBinaryData(const System::UnicodeString Name, void *Buffer, int BufSize);
Properties
Type | Visibility | Source | Unit | Parent |
---|---|---|---|---|
procedure function |
public | System.Win.Registry.pas System.Win.Registry.hpp |
System.Win.Registry | TRegistry |
Description
Stores a specifically named data value associated with the current key.
Call WriteBinaryData to store a data value associated with the current key.
Name is a string containing the name of the data value in which to store data. If Name already exists, its current value is overwritten by WriteBinary. If Name does not exist, it is created.
Buffer is a data buffer containing the data to store in the registry. BufSize indicates the size of Buffer.
Note: Data-value lengths are limited by available memory. Long values (more than 2048 bytes) should be stored as separate files, and those file names should be stored in the registry. Application elements such as icons, bitmaps, and executable files should be stored as separate files rather than as values in the registry.
If WriteBinaryData fails, an exception is raised, and the value is not written to the registry.