System.Win.Registry.TRegistry.WriteBinaryData

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

procedure WriteBinaryData(const Name: string; const Buffer; BufSize: Integer);

C++

void __fastcall WriteBinaryData(const System::UnicodeString Name, const 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.

See Also