Share via


IMLDSPlugin::UpdateWatchList (Compact 7)

3/12/2014

This method adds or removes a location to the list of monitored locations for the data source plug-in.

Syntax

HRESULT UpdateWatchList(
  int  datasourceId,
  BSTR  location,
  BOOL  fAdd,
  BOOL  *pfHandled
);

Parameters

  • datasourceId
    [in] Enumeration MLDataSourceId that identifies the data source.
  • location
    [in] Location to monitor.
  • fAdd
    [in] If true, the Media Library adds the location to the watch list; otherwise, the Media Library removes the location from the watch list.
  • pfHandled
    [out] Boolean value that is true if the data source plug-in added the location to the watch list or removed the location from the watch list. If false, the location was not added or removed.

Return Values

Returns an HRESULT value. Possible values include the following.

Return code Description

S_OK

The method was successful.

E_INVALIDARG

One or more parameters are invalid.

E_POINTER

The pHandled parameter is invalid.

E_FAIL

The method was not successful.

E_OUTOFMEMORY

An out of memory error occurred.

Remarks

The plug-in manager calls this method when the application calls IMLPushQueue::AddWatchedLocation or IMLPushQueue::RemoveWatchedLocation to add or remove a location from the list of monitored locations.

Requirements

Header

mlibdll_plugin.h,
mlibdll_plugin.idl

Library

mlibdll.lib

See Also

Reference

IMLDSPlugin