CLongBinary クラス
データベース上の大きなバイナリ データ オブジェクト (BLOB または "バイナリ ラージ オブジェクト" と呼びます) を使った作業を単純にします。
構文
class CLongBinary : public CObject
メンバー
パブリック コンストラクター
名前 | 説明 |
---|---|
CLongBinary::CLongBinary | CLongBinary オブジェクトを構築します。 |
パブリック データ メンバー
名前 | 説明 |
---|---|
CLongBinary::m_dwDataLength | ハンドルが格納されているデータ オブジェクトの実際のサイズをバイト単位で m_hData 格納します。 |
CLongBinary::m_hData | 実際のイメージ オブジェクトに対する Windows HGLOBAL ハンドルが含まれています。 |
解説
たとえば、SQL テーブルのレコード フィールドには、図を表すビットマップが含まれている場合があります。 オブジェクトは CLongBinary
、このようなオブジェクトを格納し、そのサイズを追跡します。
Note
一般に、DFX_Binary関数と組み合わせて CByteArray を使用することをお勧めします。 引き続き使用CLongBinary
できますが、16 ビットCByteArray
ではサイズの制限が発生しなくなったため、一般CByteArray
に Win32 ではより多くの機能が提供されます。 このアドバイスは、Data Access オブジェクト (DAO) および Open Database Connectivity (ODBC) を使用したプログラミングに適用されます。
オブジェクトを CLongBinary
使用するには、レコードセット クラスで型 CLongBinary
のフィールド データ メンバーを宣言します。 このメンバーは、レコードセット クラスの埋め込みメンバーになり、レコードセットが構築されるときに構築されます。 オブジェクトが CLongBinary
構築されると、レコード フィールド交換 (RFX) メカニズムは、データ ソースの現在のレコードのフィールドからデータ オブジェクトを読み込み、レコードが更新されたときにレコードに格納し直します。 RFX は、データ ソースにバイナリ ラージ オブジェクトのサイズを照会し、そのオブジェクトに (オブジェクトのm_hData
データ メンバーをCLongBinary
介して) ストレージを割り当て、データm_hData
へのハンドルを格納HGLOBAL
します。 RFX では、データ オブジェクトの実際のサイズもデータ メンバーに m_dwDataLength
格納されます。 Windows HGLOBAL
ハンドルに格納されているデータの操作に通常使用するのと同じ手法を使用して、オブジェクトm_hData
内のデータを操作します。
レコードセットを破棄すると、埋め込み CLongBinary
オブジェクトも破棄され、そのデストラクターによってデータ ハンドルの HGLOBAL
割り当てが解除されます。
ラージ オブジェクトの詳細と使用方法 CLongBinary
の詳細については、「 Recordset (ODBC) 」および 「Recordset: Working with Large Data Items (ODBC)」を参照してください。
継承階層
CLongBinary
必要条件
ヘッダー: afxdb_.h
CLongBinary::CLongBinary
CLongBinary
オブジェクトを構築します。
CLongBinary();
CLongBinary::m_dwDataLength
HGLOBAL ハンドルに格納されているデータの実際のサイズをバイト単位で m_hData
格納します。
SQLULEN m_dwDataLength;
解説
このサイズは、データに割り当てられたメモリ ブロックのサイズよりも小さい場合があります。 Win32 GLobalSize 関数を呼び出して、割り当てられたサイズを取得します。
CLongBinary::m_hData
Windows HGLOBAL ハンドルを実際のバイナリ ラージ オブジェクト データに格納します。
HGLOBAL m_hData;
関連項目
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示