IDBPropertiesImpl-Klasse

Stellt eine Implementierung für die IDBProperties Schnittstelle bereit.

Syntax

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

Parameter

T
Ihre Klasse, abgeleitet von IDBPropertiesImpl.

Anforderungen

Header: „atldb.h“

Member

Schnittstellenmethoden

Name Beschreibung
GetProperties Gibt die Werte der Eigenschaften in den Eigenschaftengruppen "Datenquelle", "Datenquelleninformationen" und "Initialisierung" zurück, die derzeit für das Datenquellenobjekt festgelegt sind, oder die Werte der Eigenschaften in der Initialisierungseigenschaftsgruppe, die derzeit für den Enumerator festgelegt sind.
GetPropertyInfo Gibt Informationen zu allen vom Anbieter unterstützten Eigenschaften zurück.
SetProperties Legt Eigenschaften in den Eigenschaftengruppen "Datenquelle" und "Initialisierung" für Datenquellenobjekte oder die Initialisierungseigenschaftsgruppe für Enumerationen fest.

Hinweise

IDBProperties ist eine obligatorische Schnittstelle für Datenquellenobjekte und eine optionale Schnittstelle für Enumeratoren. Wenn ein Enumerator jedoch IDBInitialize verfügbar macht, muss er verfügbar gemacht werdenIDBProperties. IDBPropertiesImplIDBProperties implementiert mithilfe einer statischen Funktion, die durch BEGIN_PROPSET_MAP definiert wird.

IDBPropertiesImpl::GetProperties

Gibt die Werte der Eigenschaften in den Eigenschaftengruppen "Datenquelle", "Datenquelleninformationen" und "Initialisierung" zurück, die derzeit für das Datenquellenobjekt festgelegt sind, oder die Werte der Eigenschaften in der Initialisierungseigenschaftsgruppe, die derzeit für den Enumerator festgelegt sind.

Syntax

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

Parameter

Siehe IDBProperties::GetProperties in der OLE DB-Programmierreferenz.

Einige Parameter entsprechen den Referenzparametern des OLE DB-Programmierers verschiedener Namen, die in IDBProperties::GetProperties:

OLE DB-Vorlagenparameter Referenzparameter des OLE DB-Programmierers
cPropertySets cPropertyIDSets
rgPropertySets rgPropertyIDSets
pcProperties pcPropertySets
prgProperties prgPropertySets

Hinweise

Wenn der Anbieter initialisiert wird, gibt diese Methode die Werte von Eigenschaften im DBPROPSET_DATASOURCE, DBPROPSET_DATASOURCEINFO, DBPROPSET_DBINIT Eigenschaftengruppen zurück, die derzeit für das Datenquellenobjekt festgelegt sind. Wenn der Anbieter nicht initialisiert ist, wird nur DBPROPSET_DBINIT Gruppeneigenschaften zurückgegeben.

IDBPropertiesImpl::GetPropertyInfo

Gibt Eigenschaftsinformationen zurück, die von der Datenquelle unterstützt werden.

Syntax

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

Parameter

Siehe IDBProperties::GetPropertyInfo in der OLE DB-Programmierreferenz.

Einige Parameter entsprechen den Referenzparametern des OLE DB-Programmierers verschiedener Namen, die in IDBProperties::GetPropertyInfo:

OLE DB-Vorlagenparameter Referenzparameter des OLE DB-Programmierers
cPropertySets cPropertyIDSets
rgPropertySets rgPropertyIDSets

Hinweise

Verwendet IDBInitializeImpl::m_pCUtlPropInfo , um diese Funktionalität zu implementieren.

IDBPropertiesImpl::SetProperties

Legt Eigenschaften in den Eigenschaftengruppen "Datenquelle" und "Initialisierung" für Datenquellenobjekte oder die Initialisierungseigenschaftsgruppe für Enumerationen fest.

Syntax

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

Parameter

Siehe IDBProperties::SetProperties in der OLE DB-Programmierreferenz.

Hinweise

Wenn der Anbieter initialisiert wird, legt diese Methode die Werte von Eigenschaften im DBPROPSET_DATASOURCE, DBPROPSET_DATASOURCEINFO, DBPROPSET_DBINIT Eigenschaftengruppen für das Datenquellenobjekt fest. Wenn der Anbieter nicht initialisiert ist, werden nur DBPROPSET_DBINIT Gruppeneigenschaften festgelegt.

Siehe auch

OLE DB-Anbietervorlagen
Architektur von OLE DB-Anbietervorlagen