Referência dos modelos de provedor de banco de dados OLE

As classes e interfaces para os modelos do provedor OLE DB podem ser agrupadas nas categorias a seguir. Material de referência também inclui informações sobre macros para modelos do provedor OLE DB.

As classes use a seguinte convenção de nomenclatura: uma classe nomeada com o padrão IWidgetImpl ofereceria uma implementação da interface IWidget.

Classes de sessão

• IDBCreateSessionImpl
  Cria uma nova sessão do objeto de fonte de dados e retorna a interface solicitada na sessão recém-criada. Interface obrigatória em objetos de fonte de dados.

• ISessionPropertiesImpl
  Propriedades da sessão das ferramentas chamando uma função estática definida pelo conjunto de propriedades. O mapa do conjunto de propriedades deve ser especificado em sua classe da sessão. Interface obrigatória em sessões.

Classes do conjunto de linhas

CRowsetImpl

Fornece uma implementação padrão de conjunto de linhas OLE DB sem exigir a herança múltipla das interfaces de implementação. O único método para o qual você deve fornecer uma implementação é Executar.

• CSimpleRow
  Fornece uma implementação padrão para a alça da linha, que é usada na classe de IRowsetImpl . Um identificador de linha é logicamente uma marca exclusivo de uma linha do resultado. IRowsetImpl cria uma nova CSimpleRow para cada linha solicitada em IRowsetImpl::GetNextRows.

• IAccessorImpl
  Provedores OLE DB requer implementar HACCESSOR, que é uma marca a uma matriz de estruturas de DBBINDING . Fornece HACCESSORs que é endereços de estruturas de BindType . Obrigatório em conjuntos de linhas e em comandos.

• IColumnsInfoImpl
  Delega a uma função estática definida pelo mapa da coluna do provedor. Interface obrigatória em conjuntos de linhas e em comandos.

• IConvertTypeImpl
  Fornece informações sobre a disponibilidade conversões de tipo em um comando ou em um conjunto de linhas. Obrigatório em comandos, em conjuntos de linhas, e em conjuntos de linhas do índice. Implementa a interface de IConvertType delegando a conversão o objeto fornecido pelo OLE DB.

• IDBSchemaRowsetImpl
  Implementa a interface de IDBSchemaRowset e a função templatized CreateSchemaRowsetdo designer.

• IOpenRowsetImpl
  Abre e retorna um conjunto de linhas que inclui todas as linhas de uma única tabela ou índice base. Interface obrigatória para um objeto de sessão.

• IRowsetChangeImpl
  Implementa a interface OLE DB IRowsetChange , o que permite atualizar os valores das colunas nas linhas existentes, excluindo linhas, e ao inserir novas linhas.

• IRowsetCreatorImpl
  Esta classe é herdada de IObjectWithSite e substitui IObjectWithSite::SetSite. IRowsetCreatorImpl executa as mesmas funções que IObjectWithSite mas também permite que as propriedades DBPROPCANSCROLLBACKWARDS e DBPROPCANFETCHBACKWARDSOLE DB.

• IRowsetIdentityImpl
  Implementa a interface de IRowsetIdentity , o que permite comparar se duas linhas de dados são idênticas ou não.

• IRowsetImpl
  Fornece uma implementação da interface de IRowset , que é a interface base do conjunto de linhas.

• IRowsetInfoImpl
  Implementa as propriedades do conjunto de linhas usando o mapa do conjunto de propriedades definido na sua classe de comando. Interface obrigatória em conjuntos de linhas.

• IRowsetLocateImpl
  Implementa a interface OLE DB IRowsetLocate , que busca linhas arbitrárias de um conjunto de linhas. Para oferecer suporte a indicadores do OLE DB em um conjunto de linhas, faça o conjunto de linhas herdar dessa classe.

• IRowsetNotifyCP
  O implementa passam funções para recomendar ouvintes no ponto de conexão IID_IRowsetNotify as alterações para o conteúdo do conjunto de linhas. Os consumidores que manipulam notificações implementam IRowsetNotify e registrá-lo no ponto de conexão.

• IRowsetUpdateImpl
  Implementa a interface OLE DB IRowsetUpdate , que permite que os consumidores para reter a transmissão das alterações feitas com IRowsetChange à fonte de dados e para desfazer alterações antes de transmissão.

Classes de comando

• ICommandImpl
  Fornece uma implementação da interface de ICommand . Essa interface não estiver visível, mas é controlada por ICommandTextImpl. Uma interface obrigatória no objeto de comando.

• ICommandPropertiesImpl
  Essa implementação da interface de ICommandProperties é fornecida por uma função estática definida pela macro de BEGIN_PROPSET_MAP . Obrigatório em comandos.

• ICommandTextImpl
  Conjuntos, o armazena, e retorna o texto do comando. Obrigatório em comandos.

• IDBCreateCommandImpl
  Cria um novo comando de objeto de sessão e retorna a interface solicitada no comando recém-criado. Interface opcional em objetos de sessão.

Outras classes de comando são IColumnsInfoImpl e IAccessorImpl, descritos na seção de classes do conjunto de linhas precedentes.

Classes da fonte de dados

• IDBInitializeImpl
  Cria e exclui a conexão com o consumidor. Interface obrigatória em objetos de fonte de dados e interface opcional em enumeradores.

• IDBPropertiesImpl
  IDBProperties é uma interface obrigatória para objetos de fonte de dados e uma interface opcional para enumeradores. No entanto, se expõe um enumerador IDBInitialize, deve expor IDBProperties (propriedades na fonte de dados).

• IGetDataSourceImpl
  Obtém um ponteiro de interface do objeto de fonte de dados. Interface obrigatória na sessão.

Outras classes

• CUtlProps
  As propriedades das ferramentas para uma variedade de propriedade OLE DB interface (por exemplo, IDBProperties, ISessionProperties, e IRowsetInfo).

IErrorRecordsImpl

Implementa a interface OLE DB IErrorRecords , adicionando registros e a recuperação de registros de membro de dados.

Consulte também

Conceitos

Referência dos modelos de consumidor de banco de dados OLE

Outros recursos

Modelos de banco de dados OLE