Share via


Sample Consumer Overview

The OLE DB sample consumer, SampClnt.exe, is a learning tool for application developers new to OLE DB. With it, you can learn about building OLE DB applications by displaying the code in the debugger. Although this application uses a simple interface to retrieve and log data, it demonstrates the general procedures that you need to follow to get data from an OLE DB provider that uses IOpenRowset as its only means of exposing data.

Sample Consumer Features

The sample consumer is a console application that interacts with the OLE DB sample provider, SampProv.dll. The file SampProv.dll is needed for this example and must be built from the samples directory of the Windows SDK. SampClnt.exe reads the data in the rowset exposed by SampProv.dll and writes it to the log file, SampClnt.out. The rowset is created over the entire data source, which is a comma-separated value file. SampClnt.exe uses the only command recognized by SampProv.dll, SELECT * FROM CUSTOMER.CSV, to request the data.

Sample Consumer Limitations

The following are limitations in SampClnt.exe:

  • The sample consumer exposes a limited amount of OLE DB functionality. The OLE DB interfaces, methods, and data structures used in this application are simple implementations, but they provide a simple framework that application designers can extend.

  • SampClnt.exe can open only one file: Customer.csv.

  • All routines in SampClnt.exe use the same error handling facility.

See Also

Concepts

OLE DB Sample Consumer