OLE DB プロパティについて
コンシューマは、プロパティ値を設定することで、特定のオブジェクトの動作を要求します。たとえば、プロパティを使用して、行セットによって公開されるインターフェイスを指定します。コンシューマは、プロパティ値を取得して、行セット、セッション、データ ソース オブジェクトなど、オブジェクトの機能を判断します。
各プロパティには、値、データ型、説明、および読み取り/書き込み属性があります。また、行セット プロパティの場合は、列単位で適用できるかどうかを示すインジケータがあります。
プロパティは、GUID と、プロパティ ID を表す整数で識別されます。プロパティ セットは、同じ GUID を共有するすべてのプロパティのセットです。SQL Server Native Client OLE DB プロバイダには、あらかじめ定義されている OLE DB プロパティ セットに加えて、プロバイダ固有のプロパティ セットと、そのセット内のプロパティが実装されています。各プロパティは、1 つ以上のプロパティ グループに属しています。プロパティ グループは、特定のオブジェクトに適用されるすべてのプロパティをグループ化したものです。プロパティ グループには、初期化プロパティ グループ、データ ソース プロパティ グループ、セッション プロパティ グループ、行セット プロパティ グループ、テーブル プロパティ グループ、列プロパティ グループなどがあります。これらの各プロパティ グループに、プロパティが含まれています。
プロパティ値を設定するには、次の手順を実行します。
値を設定するプロパティを決定します。
目的のプロパティを含むプロパティ セットを決定します。
目的のプロパティ セットごとに 1 つ、DBPROPSET 構造体の配列を割り当てます。
プロパティ セットごとに DBPROP 構造体の配列を割り当てます。各配列の要素数は、そのプロパティ セットに属するプロパティ (手順 1. で特定したプロパティ) の個数です。
プロパティごとに DBPROP 構造体に値を設定します。
プロパティ セットごとに DBPROPSET 構造体に情報 (プロパティ セット GUID、要素数、および対応する DBPROP 配列を指すポインタ) を設定します。
要素数と DBPROPSET 構造体の配列を渡してメソッドを呼び出し、プロパティを設定します。