Класс 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. IDBPropertiesImplIDBProperties реализуется с помощью статической функции, определенной BEGIN_PROPSET_MAP.

IDBPropertiesImpl::GetProperties

Возвращает значения свойств в группах свойств источника данных, источника данных и инициализации, которые в настоящее время задаются в объекте источника данных или значениях свойств в группе свойств инициализации, которые в настоящее время задаются в перечислителе.

Синтаксис

STDMETHOD(GetProperties)(ULONG cPropertySets,
   const DBPROPIDSET rgPropertySets[],
   ULONG * pcProperties,
   DBPROPSET ** prgProperties);

Параметры

См. раздел IDBProperties::GetProperties в справочнике программиста OLE DB.

Некоторые параметры соответствуют эталонным параметрам 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);

Параметры

См. раздел IDBProperties::GetPropertyInfo в справочнике программиста OLE DB.

Некоторые параметры соответствуют эталонным параметрам OLE DB программиста различных имен, которые описаны в IDBProperties::GetPropertyInfo:

Параметры шаблона OLE DB	Эталонные параметры OLE DB Программиста
cPropertySets	cPropertyIDSets
rgPropertySets	rgPropertyIDSets

Замечания

Использует IDBInitializeImpl::m_pCUtlPropInfo для реализации этой функции.

IDBPropertiesImpl::SetProperties

Задает свойства в группах свойств источника данных и инициализации для объектов источника данных или группы свойств инициализации для перечислителей.

Синтаксис

STDMETHOD(SetProperties)(ULONG cPropertySets,
   DBPROPSET rgPropertySets[]);

Параметры

См. раздел IDBProperties::SetProperties в справочнике программиста OLE DB.

Замечания

Если поставщик инициализирован, этот метод задает значения свойств в DBPROPSET_DATASOURCE, DBPROPSET_DATASOURCEINFO, DBPROPSET_DBINIT группы свойств для объекта источника данных. Если поставщик не инициализирован, он задает только свойства группы DBPROPSET_DBINIT.

См. также

Шаблоны поставщика OLE DB
Архитектура шаблона поставщика OLE DB