OLEDBSimpleProvider::stopTransfer

Requests that the simple provider discontinue the asynchronous transfer of data.

HRESULT stopTransfer ( );

Return Codes

S_OK

The method succeeded.

E_FAIL

A provider-specific error occurred, or the OSP was unable to stop the asynchronous transfer.

Comments

Providers should make every effort to expose the data transferred prior to receiving this request. The provider must expose a valid, consistent OSP interface for such data, including an appropriate count of the columns and rows and the read/write status.

Providers that cannot expose the data prior to receiving this request should discontinue the transfer of data and fail all subsequent calls to the OSP interface.

OLEDBSimpleProvider::stopTransfer requires the OLEDBSimpleProviderListener::transferComplete notification if provider data will populate the consumer application or control asynchronously.