OLEDBSimpleProvider

OLEDBSimpleProvider is the OSP interface that implements the methods used for data access. It specifies methods for:

OLEDBSimpleProvider is identified by the following IID:

{E0E270C0-C0BE-11d0-8FE4-00A0C90A6341}

Data References

When using OLEDBSimpleProvider methods, you reference the exposed array-like data by using row and column indices. Normally, indices begin with a value of 1. Following are two index values with special meaning:

Index Value Description
-1 Wildcard value. Refers to an unknown value or all values. For example, a row value of -1 and a column value of 2 refers to all the rows in column 2 (not including the row header information).

Note The getVariant and setVariant methods cannot use a value of -1 as an argument for the iRow and iColumn arguments.

0 Reserved for label information in the case of a row, and header information in the case of a column.

Method List

Following is a list of OLEDBSimpleProvider methods that the OLE DB Simple Provider Toolkit uses, a short description of each, and the category each method belongs to. Click on any method name for detailed information about its implementation.

Method Description Category
getRowCount Returns the number of rows. Schema
getColumnCount Returns the number of columns. Schema
getRWStatus Returns the read/write status of a column, row, cell, or data set. Schema
getVariant Retrieves the value of the cell at the indicated row and column into the pre-allocated variant. Variant
setVariant Sets the value of the cell at the row and column indicated to the value of the variant. Variant
insertRows Inserts a specified number of empty rows, starting at a specified location. Insertion and deletion
deleteRows Deletes a specified number of rows, starting at a specified location. Insertion and deletion
find Searches for the specified set of values, starting at a specified location. Search
getLocale Indicates the locale of the data. Localization
isAsync Indicates whether data is being populated asynchronously. Asynchronous data population
getEstimatedRows Returns the total estimated number of rows in the data set. Asynchronous data population
stopTransfer Requests that the OSP discontinue asynchronous transfer of data. Asynchronous data population
addOLEDBSimpleProviderListener Registers an event handler interface, making it possible to receive notifications of changes to data. Event handler
removeOLEDBSimpleProviderListener Unregisters a specified event handler interface. Event handler