IDBPropertiesImpl クラス
IDBProperties インターフェイスの実装を提供します。
構文
template <class T>
class ATL_NO_VTABLE IDBPropertiesImpl
: public IDBProperties, public CUtlProps<T>
パラメーター
T
IDBPropertiesImpl から派生したクラス。
要件
ヘッダー: atldb.h
メンバー
インターフェイス メソッド
| 名前 | 説明 |
|---|---|
| GetProperties | 現在データ ソース オブジェクトに設定されている、データ ソース、データ ソース情報、および初期化の各プロパティ グループのプロパティの値を返します。または、現在、列挙子に設定されている初期化プロパティ グループのプロパティの値を返します。 |
| GetPropertyInfo | プロバイダーでサポートされているすべてのプロパティに関する情報を返します。 |
| SetProperties | データ ソース オブジェクトについて、データ ソースおよび初期化プロパティ グループにプロパティを設定します。または、列挙子について、初期化プロパティ グループにプロパティを設定します。 |
解説
IDBProperties は、データ ソース オブジェクトには必須のインターフェイスであり、列挙子には省略可能なインターフェイスです。 ただし、列挙子が IDBInitialize を公開する場合、これは IDBProperties を公開する必要があります。 IDBPropertiesImpl は、BEGIN_PROPSET_MAP によって定義された静的関数を使用して IDBProperties を実装します。
IDBPropertiesImpl::GetProperties
現在データ ソース オブジェクトに設定されている、データ ソース、データ ソース情報、および初期化の各プロパティ グループのプロパティの値を返します。または、現在、列挙子に設定されている初期化プロパティ グループのプロパティの値を返します。
構文
STDMETHOD(GetProperties)(ULONG cPropertySets,
const DBPROPIDSET rgPropertySets[],
ULONG * pcProperties,
DBPROPSET ** prgProperties);
パラメーター
"OLE DB プログラマーズ リファレンス" の「IDBProperties::GetProperties」を参照してください。
一部のパラメーターは、"OLE DB プログラマーズ リファレンス" の IDBProperties::GetProperties で説明されている異なる名前のパラメーターに対応しています。
| OLE DB テンプレートのパラメーター | "OLE DB プログラマーズ リファレンス" のパラメーター |
|---|---|
| cPropertySets | cPropertyIDSets |
| rgPropertySets | rgPropertyIDSets |
| pcProperties | pcPropertySets |
| prgProperties | prgPropertySets |
解説
プロバイダーが初期化される場合、このメソッドは、データ ソース オブジェクトに現在設定されている、DBPROPSET_DATASOURCE、DBPROPSET_DATASOURCEINFO、DBPROPSET_DBINIT プロパティ グループのプロパティの値を返します。 プロバイダーが初期化されない場合は、DBPROPSET_DBINIT グループのプロパティのみを返します。
IDBPropertiesImpl::GetPropertyInfo
データ ソースでサポートされているプロパティ情報を返します。
構文
STDMETHOD(GetPropertyInfo)(ULONG cPropertySets,
const DBPROPIDSET rgPropertySets[],
ULONG * pcPropertyInfoSets,
DBPROPINFOSET ** prgPropertyInfoSets,
OLECHAR ** ppDescBuffer);
パラメーター
"OLE DB プログラマーズ リファレンス" の「IDBProperties::GetPropertyInfo」を参照してください。
一部のパラメーターは、"OLE DB プログラマーズ リファレンス" の IDBProperties::GetPropertyInfo で説明されている異なる名前のパラメーターに対応しています。
| OLE DB テンプレートのパラメーター | "OLE DB プログラマーズ リファレンス" のパラメーター |
|---|---|
| cPropertySets | cPropertyIDSets |
| rgPropertySets | rgPropertyIDSets |
解説
IDBInitializeImpl::m_pCUtlPropInfo を使用してこの機能を実装します。
IDBPropertiesImpl::SetProperties
データ ソース オブジェクトについて、データ ソースおよび初期化プロパティ グループにプロパティを設定します。または、列挙子について、初期化プロパティ グループにプロパティを設定します。
構文
STDMETHOD(SetProperties)(ULONG cPropertySets,
DBPROPSET rgPropertySets[]);
パラメーター
"OLE DB プログラマーズ リファレンス" の「IDBProperties::SetProperties」を参照してください。
解説
プロバイダーが初期化される場合、このメソッドは、データ ソース オブジェクトについて、DBPROPSET_DATASOURCE、DBPROPSET_DATASOURCEINFO、DBPROPSET_DBINIT プロパティ グループのプロパティの値を設定します。 プロバイダーが初期化されない場合は、DBPROPSET_DBINIT グループのプロパティのみを設定します。