IVdsAdviseSink::OnNotify method (vds.h)
Passes notifications from providers to VDS, and from VDS to applications.
HRESULT OnNotify( [in] LONG lNumberOfNotifications, [in] VDS_NOTIFICATION *pNotificationArray );
The number of notifications specified in pNotificationArray.
A pointer to an array of VDS_NOTIFICATION structures. A provider allocates the memory for the array when the provider calls into the service; the service frees the array. VDS allocates the array when the service calls into an application. In this case, callers must free the array by using the CoTaskMemFree function.
This method can return standard HRESULT values, such as E_INVALIDARG or E_OUTOFMEMORY, and VDS-specific return values. It can also return converted system error codes using the HRESULT_FROM_WIN32 macro. Errors can originate from VDS itself or from the underlying VDS provider that is being used. Possible return values include the following.
||VDS returns this value to a provider if the service is not fully initialized when the provider calls into this method, or if some notifications are lost by the service.|
An application implements this method to receive notifications from VDS. Some of these notifications originate from VDS; others are provider notifications that are forwarded by VDS.
VDS maintains a cache of information about the properties of all VDS objects, such as subsystems and controllers. Whenever a change occurs that triggers a notification, this cache is updated automatically. Also, calling IVdsHwProvider::Refresh or IVdsService::Refresh in response to a VDS notification could cause an endless loop of notifications to be sent. For these reasons, an application should not call IVdsHwProvider::Refresh or IVdsService::Refresh in its implementation of this method.
For providers that use this method to send notifications, it is good practice to group notifications originating from a single event together. For example, when a LUN is deleted, send VDS_NF_DRIVE_MODIFY notifications for all affected drives together.
|Minimum supported client||Windows Vista [desktop apps only]|
|Minimum supported server||Windows Server 2003 [desktop apps only]|