SQL Server Native Client OLE DB プロパティについて

適用対象: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

コンシューマーは、プロパティ値を設定することで、特定のオブジェクトの動作を要求します。 たとえば、プロパティを使用して、行セットによって公開されるインターフェイスを指定します。 コンシューマーは、プロパティ値を取得して、行セット、セッション、データ ソース オブジェクトなど、オブジェクトの機能を判断します。

各プロパティには、値、データ型、説明、および読み取り/書き込み属性があります。また、行セット プロパティの場合は、列単位で適用できるかどうかを示すインジケーターがあります。

プロパティは GUID およびプロパティ ID を表す整数によって識別されます。 プロパティ セットは、同じ GUID を共有するすべてのプロパティのセットです。 SQL Server Native Client OLE DB プロバイダーは、定義済みの OLE DB プロパティ セットに加えて、プロバイダー固有のプロパティ セットとプロパティを実装します。 各プロパティは、1 つ以上のプロパティ グループに属しています。 プロパティ グループは、特定のオブジェクトに適用されるすべてのプロパティをグループ化したものです。 プロパティ グループには、初期化プロパティ グループ、データ ソース プロパティ グループ、セッション プロパティ グループ、行セット プロパティ グループ、テーブル プロパティ グループ、列プロパティ グループなどがあります。 これらの各プロパティ グループに、プロパティが含まれています。

プロパティ値を設定するには、次の手順を実行します。

  1. 値を設定するプロパティを決定します。

  2. 目的のプロパティを含むプロパティ セットを決定します。

  3. 目的のプロパティ セットごとに 1 つ、DBPROPSET 構造体の配列を割り当てます。

  4. プロパティ セットごとに DBPROP 構造体の配列を割り当てます。 各配列の要素数は、そのプロパティ セットに属するプロパティ (手順 1. で特定したプロパティ) の個数です。

  5. プロパティごとに DBPROP 構造体に値を設定します。

  6. プロパティ セットごとに DBPROPSET 構造体に情報 (プロパティ セット GUID、要素数、および対応する DBPROP 配列を指すポインター) を設定します。

  7. 要素数と DBPROPSET 構造体の配列を渡してメソッドを呼び出し、プロパティを設定します。

参照

SQL Server Native Client OLE DB プロバイダー アプリケーションの作成
プロパティ [OLE DB]