System.Win.Registry.TRegistry.ReadBinaryData

Übergeordnet: TRegistry

Delphi

function ReadBinaryData(const Name: string; var Buffer; BufSize: Integer): Integer;

C++

int __fastcall ReadBinaryData(const System::UnicodeString Name, void *Buffer, int BufSize);

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
function	public	System.Win.Registry.pas System.Win.Registry.hpp	System.Win.Registry	TRegistry

Beschreibung

Liest einen Binärwert aus einem bestimmten Datenwert, der dem aktuellen Schlüssel zugeordnet ist.

Mit ReadBinaryData wird ein binärer Wert aus einem bestimmten Datenwert gelesen, der dem aktuellen Schlüssel zugeordnet ist. Der Parameter Name bezeichnet den Namen des Datenwertes. Der Parameter Buffer ist eine Anwendungsvariable, welche die gelesenen Registrierungsdaten aufnimmt. Dieser Puffer muss so groß sein, dass alle zurückgegebenen Daten Platz finden. Der Parameter BufSize ist die Größe des Puffers.

Bei erfolgreicher Ausführung schreibt ReadBinaryData die angeforderten in Buffer und gibt die Anzahl der geschriebenen Bytes zurück. Wenn der Registrierungseintrag einen bekannten Typ (z.B. einen String) enthält, wird eine Exception ausgelöst.

Anmerkung: Binärdaten sind normalerweise komplexe Datenstrukturen (ein Record in Delphi oder eine Struktur in C++). Es kann sich aber auch um ein Symbol oder ein Bitmap handeln. Microsoft empfiehlt allerdings aus Gründen der Anwendungsleistung, Grafikobjekte nicht in der Registrierung zu speichern.