addDataSourceListener

  • Article

Adds a listener to the notification list.

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 addDataSourceListener(
   DataSourceListener    *pDSL);

Parameters

  • pDSL
    [in] Pointer to the interface of the listener. In case of any event, methods are called to that interface.

Return Codes

  • S_OK
    The method succeeded.

  • E_FAIL
    A provider-specific error occurred.

Comments

Checking for duplicate items and returning an error is optional. If the data source knows it will never issue notifications (for example, the data members are always available), it need not implement this method and can just return S_OK. However, if it does issue notifications, it must multicast them. The HRESULTs returned from the multicast are ignored and do not end the multicast.