msDataSourceObject

The msDataSourceObject method described below should only be used when the provider is being written in Microsoft Visual Basic or Microsoft Visual J++. Implement msDataSourceObject in your provider code using the appropriate IDispatch methods.

If you are writing a provider in Visual Basic, msDataSourceObject provides the mechanism by which an OLE DB Rowset maps to the correct OSP implementation. The method accepts a string parameter indicating the correct OSP and returns a pointer to that OSP (which you will then Invoke using a standard IDispatch call). See the supplied Visual Basic code samples for an example.

The signature for msDataSourceObject is as follows:

HRESULT msDataSourceObject(
BSTRqualifier,
LONG**ppUnk);

Parameters

qualifier

[in]
Identifier for a data set when there is more than a single data source. When the parameter is NULL, or a null string (“”) is used, the data interface on the default data set should be returned. This string is interpreted as case-insensitive.

**punk

[out]
Interface pointer to the specified OSP implementation.