Riferimenti ai modelli del provider OLE DB
Le classi e le interfacce per i modelli di provider OLE DB possono essere raggruppate nelle categorie seguenti. Il materiale di riferimento include anche informazioni sulle macro per i modelli di provider OLE DB.
Le classi usano la convenzione di denominazione seguente: una classe denominata con il modello IWidgetImpl fornirà un'implementazione dell'interfaccia IWidget.
Classi di sessione
IDBCreateSessionImpl
Crea una nuova sessione dall'oggetto origine dati e restituisce l'interfaccia richiesta nella sessione appena creata. Interfaccia obbligatoria sugli oggetti origine dati.
ISessionPropertiesImpl
Implementa le proprietà della sessione chiamando una funzione statica definita dalla mappa del set di proprietà. La mappa del set di proprietà deve essere specificata nella classe di sessione. Interfaccia obbligatoria nelle sessioni.
Classi del set di righe
Fornisce un'implementazione standard del set di righe OLE DB senza richiedere più ereditarietà di molte interfacce di implementazione. L'unico metodo per il quale è necessario fornire l'implementazione è Execute.
CSimpleRow
Fornisce un'implementazione predefinita per l'handle di riga, che viene usato nella IRowsetImpl classe . Un handle di riga è logicamente un tag univoco per una riga di risultato. IRowsetImpl crea un nuovo CSimpleRow oggetto per ogni riga richiesta in IRowsetImpl::GetNextRows.
IAccessorImpl
OLE DB richiede che i provider implementino un oggetto HACCESSOR, ovvero un tag a una matrice di DBBINDING strutture. Fornisce HACCESSORgli indirizzi delle BindType strutture. Obbligatorio nei set di righe e nei comandi.
IColumnsInfoImpl
Delega a una funzione statica definita dalla mappa delle colonne del provider. Interfaccia obbligatoria nei set di righe e nei comandi.
IConvertTypeImpl
Fornisce informazioni sulla disponibilità delle conversioni dei tipi in un comando o in un set di righe. Obbligatorio nei comandi, nei set di righe e nei set di righe di indice. Implementa l'interfaccia IConvertType delegando all'oggetto di conversione fornito da OLE DB.
IDBSchemaRowsetImpl
Implementa l'interfaccia IDBSchemaRowset e la funzione CreateSchemaRowsetcreatore templatizzata .
IOpenRowsetImpl
Apre e restituisce un set di righe che include tutte le righe di una singola tabella o indice di base. Interfaccia obbligatoria per un oggetto sessione.
IRowsetChangeImpl
Implementa l'interfaccia OLE DB IRowsetChange , che consente l'aggiornamento dei valori delle colonne nelle righe esistenti, l'eliminazione di righe e l'inserimento di nuove righe.
IRowsetCreatorImpl
Questa classe eredita da IObjectWithSite ed esegue l'override di IObjectWithSite::SetSite. IRowsetCreatorImpl esegue le stesse funzioni di IObjectWithSite , ma abilita anche le proprietà DBPROPCANSCROLLBACKWARDS OLE DB e DBPROPCANFETCHBACKWARDS.
IRowsetIdentityImpl
Implementa l'interfaccia IRowsetIdentity , che consente di confrontare se due righe di dati sono identiche o meno.
IRowsetImpl
Fornisce un'implementazione dell'interfaccia , ovvero l'interfaccia IRowset del set di righe di base.
IRowsetInfoImpl
Implementa le proprietà del set di righe usando la mappa del set di proprietà definita nella classe di comando. Interfaccia obbligatoria nei set di righe.
IRowsetLocateImpl
Implementa l'interfaccia OLE DB IRowsetLocate , che recupera righe arbitrarie da un set di righe. Per supportare i segnalibri OLE DB in un set di righe, impostare l'ereditarietà del set di righe da questa classe.
IRowsetNotifyCP
Implementa le funzioni di trasmissione per consigliare i listener sul punto IID_IRowsetNotify di connessione delle modifiche apportate al contenuto del set di righe. I consumer che gestiscono le notifiche implementano IRowsetNotify e lo registrano in tale punto di connessione.
IRowsetUpdateImpl
Implementa l'interfaccia OLE DB IRowsetUpdate , che consente ai consumer di ritardare la trasmissione delle modifiche apportate con IRowsetChange all'origine dati e annullare le modifiche prima della trasmissione.
Classi di comandi
ICommandImpl
Fornisce un'implementazione dell'interfaccia ICommand. Questa interfaccia non è visibile, ma viene gestita da ICommandTextImpl. Interfaccia obbligatoria nell'oggetto comando.
ICommandPropertiesImpl
Questa implementazione dell'interfaccia ICommandProperties viene fornita da una funzione statica definita dalla BEGIN_PROPSET_MAP macro. Obbligatorio nei comandi.
ICommandTextImpl
Imposta, archivia e restituisce il testo del comando. Obbligatorio nei comandi.
IDBCreateCommandImpl
Crea un nuovo comando dall'oggetto sessione e restituisce l'interfaccia richiesta nel comando appena creato. Interfaccia facoltativa sugli oggetti sessione.
Altre classi di comandi sono IColumnsInfoImpl e IAccessorImpl, descritte nella sezione Classi del set di righe precedente.
Classi di origine dati
IDBInitializeImpl
Crea ed elimina la connessione con il consumer. Interfaccia obbligatoria per gli oggetti origine dati e l'interfaccia facoltativa sugli enumeratori.
IDBPropertiesImpl
IDBProperties è un'interfaccia obbligatoria per gli oggetti origine dati e un'interfaccia facoltativa per gli enumeratori. Tuttavia, se un enumeratore espone IDBInitialize, deve esporre IDBProperties (proprietà nell'origine dati).
IGetDataSourceImpl
Ottiene un puntatore di interfaccia all'oggetto origine dati. Interfaccia obbligatoria nella sessione.
Altre classi
CUtlProps
Implementa le proprietà per un'ampia gamma di interfacce delle proprietà OLE DB , ad esempio , IDBPropertiesISessionPropertiese IRowsetInfo.
Implementa l'interfaccia OLE DB IErrorRecords , aggiungendo record e recuperando record da un membro dati.