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);
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
function | public | System.Win.Registry.pas System.Win.Registry.hpp |
System.Win.Registry | TRegistry |
説明
カレントキーに関連付けられた特定のデータ値からバイナリ値を取得します。
ReadBinaryData を呼び出すと,カレントキーに関連付けられた特定のデータ値からバイナリ値を読み出すことができます。Name は読み出すデータ値の名前です。Buffer はレジストリデータを読み出すアプリケーション変数です。Buffer は返されるデータがすべて格納できるサイズでなければなりません。BufSize は Buffer のサイズを指定します。
正常に処理されれば,ReadBinaryData は要求されたデータを Buffer に書き込み,書き込まれたバイト数を返します。Registry エントリが既知の型(文字列型など)を格納している場合,ReadBinaryData は例外を生成します。
メモ: バイナリデータは普通,複雑なデータ構造です(Delphi の場合レコード,C++ の場合構造体)。バイナリデータはアイコンやビットマップであってもかまいませんが,マイクロソフトは速度の低下を理由にグラフィックオブジェクトをレジストリに格納しないように勧めています。