Classe IDBPropertiesImpl

Fornece uma implementação para a interface IDBProperties.

Sintaxe

template <class T>
class ATL_NO_VTABLE IDBPropertiesImpl
   : public IDBProperties, public CUtlProps<T>

Parâmetros

T
Sua classe, derivada de IDBPropertiesImpl.

Requisitos

Cabeçalho: atldb.h

Membros

Métodos de interface

Nome	Descrição
GetProperties	Retorna os valores das propriedades nos grupos de propriedades Fonte de Dados, Informações da Fonte de Dados e Inicialização que estão atualmente definidos no objeto da fonte de dados ou nos valores das propriedades no grupo de propriedades Inicialização, que estão atualmente definidos no enumerador.
GetPropertyInfo	Retorna informações sobre todas as propriedades compatíveis com o provedor.
SetProperties	Define propriedades nos grupos de propriedades Fonte de Dados e Inicialização para objetos de fonte de dados ou no grupo de propriedades Inicialização para enumeradores.

Comentários

IDBProperties é uma interface obrigatória para objetos de fonte de dados e uma interface opcional para enumeradores. No entanto, se um enumerador expõe IDBInitialize, ele precisa expor IDBProperties. IDBPropertiesImpl implementa IDBProperties usando uma função estática definida por BEGIN_PROPSET_MAP.

IDBPropertiesImpl::GetProperties

Retorna os valores das propriedades nos grupos de propriedades Fonte de Dados, Informações da Fonte de Dados e Inicialização que estão atualmente definidos no objeto da fonte de dados ou nos valores das propriedades no grupo de propriedades Inicialização, que estão atualmente definidos no enumerador.

Sintaxe

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

Parâmetros

Confira IDBProperties::GetProperties na Referência de programador do OLE DB.

Alguns parâmetros correspondem aos parâmetros da Referência de programador do OLE DB de nomes diferentes, que são descritos em IDBProperties::GetProperties:

Parâmetros de modelo do OLE DB	Parâmetros da Referência de programador do OLE DB
cPropertySets	cPropertyIDSets
rgPropertySets	rgPropertyIDSets
pcProperties	pcPropertySets
prgProperties	prgPropertySets

Comentários

Se o provedor for inicializado, esse método retornará os valores das propriedades nos grupos de propriedades DBPROPSET_DATASOURCE, DBPROPSET_DATASOURCEINFO DBPROPSET_DBINIT atualmente definidos no objeto de fonte de dados. Se o provedor não for inicializado, ele retornará somente as propriedades do grupo DBPROPSET_DBINIT.

IDBPropertiesImpl::GetPropertyInfo

Retorna informações de propriedade compatíveis com a fonte de dados.

Sintaxe

STDMETHOD(GetPropertyInfo)(ULONG cPropertySets,
   const DBPROPIDSET rgPropertySets[],
   ULONG * pcPropertyInfoSets,
   DBPROPINFOSET ** prgPropertyInfoSets,
   OLECHAR ** ppDescBuffer);

Parâmetros

Confira IDBProperties::GetPropertyInfo na Referência de programador do OLE DB.

Alguns parâmetros correspondem aos parâmetros da Referência de programador do OLE DB de nomes diferentes, que são descritos em IDBProperties::GetPropertyInfo:

Parâmetros de modelo do OLE DB	Parâmetros da Referência de programador do OLE DB
cPropertySets	cPropertyIDSets
rgPropertySets	rgPropertyIDSets

Comentários

Usa IDBInitializeImpl::m_pCUtlPropInfo para implementar essa funcionalidade.

IDBPropertiesImpl::SetProperties

Define propriedades nos grupos de propriedades Fonte de Dados e Inicialização para objetos de fonte de dados ou no grupo de propriedades Inicialização para enumeradores.

Sintaxe

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

Parâmetros

Confira IDBProperties::SetProperties na Referência de programador do OLE DB.

Comentários

Se o provedor for inicializado, esse método definirá os valores das propriedades nos grupos de propriedades DBPROPSET_DATASOURCE, DBPROPSET_DATASOURCEINFO DBPROPSET_DBINIT para o objeto de fonte de dados. Se o provedor não for inicializado, ele definirá somente as propriedades do grupo DBPROPSET_DBINIT.

Confira também

Modelos de Provedor OLE DB
Arquitetura de modelo do provedor do OLE DB