IDBPropertiesImpl 類別
提供介面的實作 IDBProperties 。
語法
template <class T>
class ATL_NO_VTABLE IDBPropertiesImpl
: public IDBProperties, public CUtlProps<T>
參數
T
您的類別衍生自 IDBPropertiesImpl。
需求
Header: atldb.h
成員
介面方法
| 名稱 | 描述 |
|---|---|
| GetProperties | 傳回數據源、數據源資訊及初始化屬性群組中目前在數據源對象上設定的屬性值，或目前在列舉值上設定之初始化屬性群組中的屬性值。 |
| GetPropertyInfo | 傳回提供者所支援之所有屬性的相關信息。 |
| SetProperties | 設定列舉值之數據源和初始化屬性群組中的屬性、數據源物件或初始化屬性群組的屬性。 |
備註
IDBProperties 是數據源物件的必要介面，也是列舉值的選擇性介面。 不過，如果列舉值公開 IDBInitialize，則必須公開 IDBProperties。 IDBPropertiesImpl使用IDBProperties由 BEGIN_PROPSET_MAP 定義的靜態函式來實作 。
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群組屬性。