removeOLEDBSimpleProviderListener

  • Article

Unregisters a named event handler interface.

Important

This feature will be removed in a future version of Windows. Avoid using this feature in new development work, and plan to modify applications that currently use this feature. Instead, write a fully functional OLE DB provider using the native OLE DB interfaces.

Syntax

HRESULT removeOLEDBSimpleProviderListener (
   OLEDBSimpleProviderListener    *pospIListener);

Parameters

  • pospIListener
    [in] The event handler interface to be unregistered.

Return Codes

  • S_OK
    The method succeeded.

  • E_FAIL
    A provider-specific error occurred.

Comments

If OLEDBSimpleProvider::removeOLEDBSimpleProviderListener specifies an event handler interface different from the one previously registered, code the call to fail with E_FAIL.

To correctly implement a provider built with the OSP Toolkit, the listener must be the OLE DB Simple Provider DLL (Msdaosp.dll).

For multiple OLE DB rowsets over the same data set, your implementation must support multiple listeners; otherwise, only one "active" rowset will be allowed.